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:
- Install & First Session — install, connect, and run a working session in 5 minutes
- 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
See CONTRIBUTING.md for code, testing, review, and verification requirements. Agent-specific repository guidance is in AGENTS.md.
Apache 2.0