Install Papercup
Three paths, all end with the same running bot. Pick whichever fits.
Requirements
- Node 20+ (the bot)
- Python 3.10+ (Whisper + Kokoro sidecars)
- espeak-ng (Kokoro phonemizer dep) —
apt-get install espeak-ngorbrew install espeak-ng - build-essential + python3-dev on Linux for native Node deps
- One of:
claudeCLI logged in,codexCLI logged in, or an Anthropic API key
Disk + memory
| What | Disk |
|---|---|
| Node deps | ~250 MB |
| Python venv (faster-whisper + kokoro-onnx) | ~700 MB |
| Voice models (Silero, Kokoro, voices) | ~355 MB |
| Total | ~1.3 GB |
Memory: ~1 GB resident at idle, more under load.
Pick your path
- One-liner installer → Fastest. Form on the home page generates a customized
bash <(curl ...)command. - Windows install → Native Windows + WSL2 paths via
install.ps1. - Claude Code plugin → Drive setup through
/papercup:setupslash commands. Best if you live in Claude Code. - Standalone (manual) → Clone, npm, venv, models, .env — explicit step-by-step.
- OpenClaw plugin → Coming soon — Papercup's voice stack as an OpenClaw skill.