Comprehensive step-by-step guide covering:
- ccproxy installation from source (patched fork required for Claude 4+)
- ccproxy OAuth login via `ccproxy auth login claude-api`
- EvoScientist install with telegram + stt extras using uv
- STT model pre-download to avoid first-message delay
- launchd plist setup for auto-start on login with KeepAlive
- Full troubleshooting section based on real deployment experience:
- OAuth token not found (.credentials.json location)
- Packages installed in wrong Python environment (conda vs .venv)
- Shell glob eating brackets in pip install 'pkg[extra]'
- Whisper hallucination / VAD filter
- ffmpeg approval prompts → --auto-approve
- heredoc variable expansion gotcha
- External drive mount timing with launchd
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Xi Zhang <106144707+X-iZhang@users.noreply.github.com>
Jiao Huifeng