selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Pizza Bot logo

Self-host Pizza Bot

v1.2.0

Inbox for managing long-running AI agent tasks

ReleaseOpen SourceApache-2.0
Updatedlast week
LanguageTypescript
Setup difficultyAdvanced
Stars
529
Port
8080 (API server HTTP/SSE)
Requires
Node.js
Docker
ghcr.io/pizza-bot-app/pizza-bot
Install with Node.js
Pizza Bot inbox showing unread work, approval request, completed launch brief, and delegated agent activity

What is Pizza Bot?

Pizza Bot is a local-first inbox application for managing long-running AI agent tasks. Users can start or schedule tasks, walk away, and return to completed work in an Unread queue and decisions waiting in an Action queue. The app supports multiple model providers. It features approvals requiring human input, long-term memory, file attachments, desktop notifications, and explicit local folder access grants. The architecture uses a stateful API server that can run embedded in an Electron desktop app, as a standalone backend for remote clients, or in a container. Frontends include Electron desktop, browser-based React UI, and a terminal CLI, all communicating over HTTP/SSE. Extensibility comes through the Model Context Protocol, agent skills, and a plugin system. Data stays local by default with SQLite persistence.

Should you self-host Pizza Bot?

Pizza Bot scores 54/100 on selfhost.directory (how scoring works) and ranks #74 of 209 in AI Agents. It has 529 GitHub stars.

It shipped 3 stable releases in the past year. The latest, v1.2.0, came out on 2 October 2026. New versions land roughly every 2 weeks.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Orca (91/100, 108 446 stars). It scores higher overall, so compare the two before you pick. See Pizza Bot vs Orca side by side.

Features

  • Agent Skills
  • Browser-Based UI
  • Checkpointed runs
  • Cron and webhook triggers
  • Desktop notifications
  • Electron Desktop App
  • Explicit folder access grants
  • File attachments
  • Human-in-the-Loop Approvals
  • Local-first inbox for AI agents
  • Long-term Memory
  • MCP server support
  • Multiple model providers
  • Plugin System
  • Terminal CLI

Pizza Bot README

How to install Pizza Bot

Install Pizza Bot with Node.js

Environment variables
PIZZA_DATA_ROOT, PIZZA_HOST, PORT, PIZZA_API_TOKEN, PIZZA_ALLOWED_ORIGINS

npm run backend:bundle PIZZA_DATA_ROOT="$HOME/.pizza-bot-server" PIZZA_HOST=127.0.0.1 PORT=8080 node dist/backend/start.mjs

Production artifact, no repo needed at runtime

How to configure Pizza Bot

  • PIZZA_ALLOWED_ORIGINShttp://localhost:5173,http://127.0.0.1:5173Comma-separated list of allowed origins for CORS

    Comma-separated list of allowed origins for CORS

  • PIZZA_ALLOW_LOCAL_FOLDER_CONFIGURATION0Enable local folder configuration API (default: disabled)

    Enable local folder configuration API (default: disabled)

    values: 0 or 1

  • PIZZA_API_TOKENBearer token for API authentication (minimum 32 characters)

    Bearer token for API authentication (minimum 32 characters)

  • PIZZA_DATA_ROOT~/.pizza-bot-ossData directory for application state (default: ~/.pizza-bot-oss)

    Data directory for application state (default: ~/.pizza-bot-oss)

  • PIZZA_HOST127.0.0.1Bind address for API server (default: 127.0.0.1)

    Bind address for API server (default: 127.0.0.1)

  • PIZZA_LOCAL_FOLDER_BROWSE_ROOTSCanonical roots for server-side folder picker

    Canonical roots for server-side folder picker

  • PIZZA_MCP_CONNECTION_TIMEOUT_MS20000MCP server connection timeout in milliseconds (default: 20000)

    MCP server connection timeout in milliseconds (default: 20000)

  • PIZZA_MCP_STARTUP_CONCURRENCY3Max concurrent MCP server connections at startup (default: 3)

    Max concurrent MCP server connections at startup (default: 3)

  • PIZZA_MODELModel selection in format provider:id

    Model selection in format provider:id

  • PIZZA_PLAYWRIGHT_BROWSER_PATHPath to browser for Playwright plugin

    Path to browser for Playwright plugin

  • PIZZA_WEB_DIR/opt/pizza-bot/webDirectory for bundled browser app

    Directory for bundled browser app

  • PORT8080Port for API server (default: 8080)

    Port for API server (default: 8080)

Pizza Bot releases & version history

More in Chat

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…