#!/usr/bin/env bash # ============================================================================ # voice-claude — ONE-SHOT INSTALLER (Ubuntu) # # A two-way voice + text bridge to Claude Code over Mumble. Speak on your phone # -> faster-whisper -> typed into a tmux Claude Code session; Claude's replies # -> Kokoro neural TTS -> streamed back to your phone. # # This ONE file is self-contained: all the bridge code is embedded as a base64 # payload at the bottom. Drop it on a fresh server and run it — nothing else to # copy first. # # *** WRITTEN FOR UBUNTU (apt + systemd). *** # On Debian it should work as-is. On a non-apt distro (Fedora/RHEL/Arch/…) # you'll need to adjust the package-install step (section 1) and the Mumble # service/ini handling yourself — everything else is distro-agnostic. # # USAGE on a fresh Ubuntu server (as root): # 1. On a machine where you're logged into Claude, mint a long-lived token: # claude setup-token # prints sk-ant-oat01-... # 2. Download this script and run it, passing the token: # curl -fsSL https://iamdev.net/wp-content/uploads/2026/06/voice-claude-setup.sh -o setup.sh # sudo CLAUDE_CODE_OAUTH_TOKEN="sk-ant-oat01-..." bash setup.sh # (or add 'export CLAUDE_CODE_OAUTH_TOKEN=...' to /root/.bashrc first, then # just: sudo bash setup.sh) # # To also join Tailscale headlessly (recommended — keeps the mic line private), # pass an auth key from the Tailscale admin console: # sudo TS_AUTHKEY="tskey-auth-..." CLAUDE_CODE_OAUTH_TOKEN="sk-ant-oat01-..." bash setup.sh # Without it, Tailscale installs and you finish with 'tailscale up' manually. # # AFTER INSTALL — edit /root/voice-claude/config.yaml: # - set a real mumble.password (and match it in the Mumble server ini) # - point claude.cwd at the project directory Claude should work in # Then: systemctl start voice-claude (watch: tmux attach -t voice) # # Idempotent: safe to re-run. Re-downloads only missing model files. # ============================================================================ set -euo pipefail HERE="/root/voice-claude" MUMBLE_PORT="64738" MUMBLE_PASS="CHANGE-ME" # must match mumble.password in config.yaml — change BOTH PROJECT_DIR="/root/project" # default Claude working dir (edit config.yaml to change) [ "$(id -u)" -eq 0 ] || { echo "run as root: sudo bash setup.sh"; exit 1; } if ! command -v apt-get >/dev/null 2>&1; then echo "!! This installer targets Ubuntu/Debian (apt). On your distro, install the" echo " equivalents of: mumble-server tmux ffmpeg espeak-ng jq python3-venv," echo " then adapt sections 1 and 5 below. Aborting to avoid a half-install." exit 1 fi echo "==> 0/8 unpacking embedded bridge code to $HERE" mkdir -p "$HERE" "$PROJECT_DIR" # everything below the __PAYLOAD__ marker is a base64 tar.gz of the bridge code LINE=$(awk '/^__PAYLOAD__$/{print NR+1; exit}' "$0") tail -n +"$LINE" "$0" | base64 -d | tar xzf - -C "$HERE" echo " unpacked $(ls -1 "$HERE"/*.py 2>/dev/null | wc -l) python files + scripts" echo "==> 1/8 system packages (apt)" export DEBIAN_FRONTEND=noninteractive apt-get update -qq apt-get install -y --no-install-recommends \ mumble-server tmux ffmpeg espeak-ng jq \ python3 python3-venv python3-pip python3-dev build-essential \ curl ca-certificates git echo "==> 2/8 Claude Code CLI" if ! command -v claude >/dev/null 2>&1; then curl -fsSL https://claude.ai/install.sh | bash fi grep -q '.local/bin' /root/.bashrc 2>/dev/null || \ echo 'export PATH="$HOME/.local/bin:$PATH"' >> /root/.bashrc echo "==> 3/8 python venv + requirements" [ -d "$HERE/venv" ] || python3 -m venv "$HERE/venv" "$HERE/venv/bin/pip" install --quiet --upgrade pip "$HERE/venv/bin/pip" install --quiet kokoro-onnx onnxruntime "$HERE/venv/bin/pip" install --quiet -r "$HERE/requirements.txt" echo "==> 4/8 voice models (~420MB, only what's missing)" mkdir -p "$HERE/voices" dl() { [ -s "$2" ] || { echo " downloading $(basename "$2")"; curl -fsSL "$1" -o "$2"; }; } KREL="https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0" dl "$KREL/kokoro-v1.0.onnx" "$HERE/voices/kokoro-v1.0.onnx" dl "$KREL/voices-v1.0.bin" "$HERE/voices/voices-v1.0.bin" echo "==> 5/8 Mumble server config" # Ubuntu's mumble-server package ships the ini in one of a few places; find it. MCONF="" for c in /etc/mumble/mumble-server.ini /etc/mumble-server.ini /etc/murmur.ini; do [ -f "$c" ] && { MCONF="$c"; break; } done if [ -n "$MCONF" ]; then sed -i -E "s/^;?serverpassword=.*/serverpassword=$MUMBLE_PASS/" "$MCONF" sed -i -E "s/^;?port=.*/port=$MUMBLE_PORT/" "$MCONF" grep -q '^serverpassword=' "$MCONF" || echo "serverpassword=$MUMBLE_PASS" >> "$MCONF" # Editing can strip the ini's group ownership; Murmur then crash-loops with a # cryptic "ini could not be opened". Restore the ownership/mode it requires. chown root:mumble-server "$MCONF" 2>/dev/null || true chmod 640 "$MCONF" 2>/dev/null || true else echo " !! couldn't find the Mumble ini; set serverpassword/port by hand." fi systemctl enable --now mumble-server echo "==> 6/8 Tailscale (private path from your phone to this box)" if ! command -v tailscale >/dev/null 2>&1; then curl -fsSL https://tailscale.com/install.sh | sh fi systemctl enable --now tailscaled if tailscale status >/dev/null 2>&1; then echo " already connected: $(tailscale ip -4 2>/dev/null | head -1)" elif [ -n "${TS_AUTHKEY:-}" ]; then tailscale up --authkey "$TS_AUTHKEY" --ssh --hostname voice-claude echo " connected: $(tailscale ip -4 2>/dev/null | head -1)" else echo " !! not connected. Run 'tailscale up' and open the printed URL, OR" echo " re-run with TS_AUTHKEY=tskey-auth-... to join headless." fi echo "==> 7/8 Claude auth token" # Interactive browser login can't complete on a headless box — the long-lived # token is the way. systemd doesn't source .bashrc, so cache it where the # service's EnvironmentFile= can read it. if [ -n "${CLAUDE_CODE_OAUTH_TOKEN:-}" ] && ! grep -q 'CLAUDE_CODE_OAUTH_TOKEN' /root/.bashrc 2>/dev/null; then printf 'export CLAUDE_CODE_OAUTH_TOKEN="%s"\n' "$CLAUDE_CODE_OAUTH_TOKEN" >> /root/.bashrc echo " saved token to /root/.bashrc" fi TOK="$(awk -F= '/^[[:space:]]*export[[:space:]]+CLAUDE_CODE_OAUTH_TOKEN=/{sub(/^[^=]*=/,"");gsub(/^"|"$|^'\''|'\''$/,"");print;exit}' /root/.bashrc 2>/dev/null || true)" [ -z "$TOK" ] && TOK="${CLAUDE_CODE_OAUTH_TOKEN:-}" if [ -n "$TOK" ]; then mkdir -p /root/.config ( umask 077; printf 'CLAUDE_CODE_OAUTH_TOKEN=%s\n' "$TOK" > /root/.config/voice-claude.env ) echo " token cached to /root/.config/voice-claude.env" else echo " !! NO TOKEN. Run 'claude setup-token' on a logged-in machine, add" echo " 'export CLAUDE_CODE_OAUTH_TOKEN=...' to /root/.bashrc, then re-run." fi echo "==> 8/8 systemd service" chmod +x "$HERE"/*.sh install -m 0644 "$HERE/voice-claude.service" /etc/systemd/system/voice-claude.service systemctl daemon-reload systemctl enable voice-claude.service cat <