A self-hosted web interface and relay server for the pi coding agent. Stream live AI coding sessions to any browser and interact remotely from mobile or desktop — no terminal required.
# Run without installing
npx @pizzapi/pizza
# — or — install globally
npm install -g @pizzapi/pizza
pizzapiThe first time you run pizzapi, a setup wizard walks you through connecting to a relay server. It takes about 30 seconds.
pizzapi localOne command starts the local relay, web UI, and runner and opens your browser at http://localhost:7492. Re-running is safe and idempotent. The relay stays running after the command exits; stop it with pizzapi web stop.
For production Docker hosting with persistent config and HTTPS, use pizzapi web:
pizzapi webOne command clones the repo, builds a Docker image, and starts the relay + web UI at http://localhost:7492.
Full docs are at pizzaface.github.io/PizzaPi — including:
- Getting Started — up and running in 5 minutes
- Installation — platform-specific notes and install methods
- CLI Reference — all commands and flags
- Configuration — config files, env vars, model defaults
- Self-Hosting — production Docker setup with HTTPS
- Runner Daemon — headless agent sessions from the web UI
- Development — local dev setup, testing, and contributing
- Architecture — relay protocol, event flow, and component design
Apache 2.0