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.

Quick Start

# Run without installing
npx @pizzapi/pizza

# — or — install globally
npm install -g @pizzapi/pizza
pizzapi

The first time you run pizzapi, a setup wizard walks you through connecting to a relay server. It takes about 30 seconds.

Self-Host the Relay (One Command)

pizzapi local

One 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 web

One command clones the repo, builds a Docker image, and starts the relay + web UI at http://localhost:7492.

Documentation

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

Screenshots:

Contributing

See CONTRIBUTING.md for code, testing, review, and verification requirements. Agent-specific repository guidance is in AGENTS.md.

License

Apache 2.0