Install ClawMux — macOS Together¶

# Verify Apple Silicon
sysctl -n machdep.cpu.brand_string  # Must show "Apple M..."

# Python
python3 --version  # Must be 3.10+

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

# tmux
which tmux || brew install tmux

# Claude Code
claude --version  # Must be installed and authenticated

if [ ! -d "$HOME/GIT/clawmux" ]; then
    mkdir -p "$HOME/GIT"
    git clone https://github.com/zeulewan/clawmux.git "$HOME/GIT/clawmux"
fi
cd "$HOME/GIT/clawmux"

cd "$HOME/GIT/clawmux"
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Install whisper.cpp via Homebrew
brew install whisper-cpp

# Download the large-v3 model for best accuracy
WHISPER_MODELS="$HOME/.clawmux/services/whisper/models"
mkdir -p "$WHISPER_MODELS"
if [ ! -f "$WHISPER_MODELS/ggml-large-v3.bin" ]; then
    curl -L "https://huggingface.co/gguf-org/whisper-large-v3-GGUF/resolve/main/ggml-large-v3.bin" \
         -o "$WHISPER_MODELS/ggml-large-v3.bin"
fi

# Start Whisper server on port 2022
if ! curl -s http://127.0.0.1:2022/v1/models > /dev/null 2>&1; then
    whisper-server \
        --model "$WHISPER_MODELS/ggml-large-v3.bin" \
        --port 2022 \
        --host 127.0.0.1 &
    sleep 2
fi

# Install mlx-audio for Apple Silicon optimized TTS
pip install mlx-audio

# Start Kokoro TTS on port 8880
if ! curl -s http://127.0.0.1:8880/v1/models > /dev/null 2>&1; then
    mlx_audio serve --port 8880 --host 127.0.0.1 &
    sleep 3
fi

INSTALL_DIR="$HOME/GIT/clawmux"
claude mcp add -s user clawmux -- "$INSTALL_DIR/.venv/bin/python" "$INSTALL_DIR/server/mcp_server.py"

mkdir -p ~/.claude/commands
cp "$HOME/GIT/clawmux/.claude/commands/clawmux.md" ~/.claude/commands/clawmux.md

# Review the script first
cat "$HOME/GIT/clawmux/clawmux" | head -20

# Option A: User-local install (no sudo needed)
mkdir -p ~/.local/bin
cp "$HOME/GIT/clawmux/clawmux" ~/.local/bin/clawmux
chmod +x ~/.local/bin/clawmux
# Ensure ~/.local/bin is in your PATH

# Option B: System-wide install
sudo cp "$HOME/GIT/clawmux/clawmux" /usr/local/bin/clawmux
sudo chmod +x /usr/local/bin/clawmux

cd "$HOME/GIT/clawmux"
./start-hub.sh

tmux new-session -d -s clawmux "cd $HOME/GIT/clawmux && ./start-hub.sh"

sudo tailscale serve --bg --https=3460 http://127.0.0.1:3460

# Hub running
curl -s http://localhost:3460/api/sessions | python3 -c "import sys,json; print(len(json.load(sys.stdin)), 'sessions')"

# TTS working
curl -s http://127.0.0.1:8880/v1/models | head -c 100

# STT working
curl -s http://127.0.0.1:2022/v1/models | head -c 100

# Browser UI
echo "Open http://localhost:3460 in your browser"