Mac & Linux Setup Guide

Complete setup for Alertness AI Suite

🍎 macOS
🐧 Ubuntu/Debian
🎩 Fedora/RHEL
1

Install Homebrew (if not installed)

Homebrew is the package manager for macOS:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2

Install Python 3.11+

brew install python@3.11

Verify:

python3 --version
3

Install FFmpeg

brew install ffmpeg

Verify:

ffmpeg -version
4

Install Claude Code

Open Terminal and run:

curl -fsSL https://claude.ai/install.sh | bash

Verify:

claude --version
1

Update System Packages

sudo apt update && sudo apt upgrade -y
2

Install Python 3.11+

sudo apt install python3.11 python3.11-venv python3-pip -y
Ubuntu 22.04 or older? Add the deadsnakes PPA first: sudo add-apt-repository ppa:deadsnakes/ppa -y && sudo apt update
3

Install FFmpeg

sudo apt install ffmpeg -y
4

Install Claude Code

curl -fsSL https://claude.ai/install.sh | bash
1

Update System Packages

sudo dnf update -y
2

Install Python 3.11+

sudo dnf install python3.11 python3-pip -y
3

Install FFmpeg

Enable RPM Fusion first (for FFmpeg):

sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm -y

Then install FFmpeg:

sudo dnf install ffmpeg -y
4

Install Claude Code

curl -fsSL https://claude.ai/install.sh | bash
5

Get Anthropic Max Plan

Claude Code requires the Anthropic Max subscription ($100/month) for unlimited usage.

🚀 Get Max Plan ($100/month) 💳 Or Use API Credits

After subscribing, run claude and follow the login prompts.

✅ Verification Checklist

Run these commands to verify everything is installed:

python3 --version # Should show 3.11+ pip3 --version # Should show pip ffmpeg -version # Should show FFmpeg info claude --version # Should show Claude Code version