pizza-bot README

The project's README from github.com/pizza-bot-app/pizza-bot. As one markdown file: README.md.

Pizza Bot

Pizza Bot

An inbox for long-running AI work.
Start or schedule a task, walk away, and come back to finished work in Unread and decisions waiting for you in Action.

CI status Latest release Apache 2.0 license Runs on macOS, Windows, and Linux Requires Node.js 24 or newer GitHub Discussions

Download · Quick start · Why Pizza Bot · Extend · Architecture · Contributing · Roadmap · Discussions

Pizza Bot inbox showing unread work, an approval request, a completed launch brief, and delegated agent activity

Agents keep working when you navigate away or disconnect; only the api-server process must remain running. A stateful DeepAgents/LangGraph runtime serves the same React experience in Electron and the browser, and the desktop app, web app, and terminal CLI all talk to the api-server over HTTP/SSE.

Pizza Bot was developed at Amazon and is released under the Apache 2.0 license.

Why Pizza Bot?

Download

Installers are attached to every release, with a SHA256SUMS to check a download against.

Platform Packages Notes
macOS (Apple silicon, Intel) .dmg, .zip Signed and notarized
Windows (x64) -setup.exe
Linux (x64, arm64) .deb, .rpm Not signed; verify against SHA256SUMS

Quick start

Node.js 24 or newer is required.

npm install
npm run build
npm run dev

npm run dev starts the Vite frontend and Electron desktop shell. The shell forks and supervises its own api-server, matching the packaged application's process model. Configure a model under Settings > Providers before starting a live run.

See Running from source for isolated data roots, browser and CLI development, desktop packages, and remote backends.

Ways to run

Experience Best for Start here
Electron desktop Local inbox with an embedded backend npm run dev
Browser Web development or static deployment Browser development
Terminal CLI Scripts, terminals, and remote backends CLI
Standalone backend Remote Electron, browsers, containers, or Linux services Backend guide

A running api-server needs access to at least one model provider; HTTP clients do not. Configure Amazon Bedrock, Anthropic, Google Gemini, OpenAI, OpenRouter, or Ollama in Settings > Providers. Bedrock accepts an AWS profile, AWS access keys, or a Bedrock API key, with an optional region override; otherwise AWS_REGION or us-west-2 is used. Bedrock combines its native catalog with the regional Mantle catalog and routes models through Converse, OpenAI Responses or Chat Completions, or Anthropic Messages according to their advertised API family. OpenAI and Anthropic also accept custom base URLs for compatible endpoints; OpenAI can explicitly select Responses or Chat Completions, and Anthropic supports x-api-key or bearer authentication. Select a model with PIZZA_MODEL=<provider>:<id>. The desktop protects entered secrets with Electron safeStorage; server configuration persists only environment-variable references.

Extend it

Add MCP servers from the UI or <PIZZA_DATA_ROOT>/.mcp.json. Add Agent Skills under <PIZZA_DATA_ROOT>/skills, or install plugins that package MCP servers and skills together. Skills become available after their declared tools are enabled and connected. A custom skill can replace a Built-in or Plugin skill with the same id without modifying the original; removing the customization reveals the Built-in or Plugin version again. The Built-in Pizza Bot Guide can explain features, suggest workflows, help with setup, and point to project documentation.

See Extending Pizza Bot for configuration, environment references, skill authoring, approval gates, and plugin installation.

Project layout

apps/        api-server (Hono) | cli | desktop-shell (Electron) | web (React)
packages/    core | runtime-langgraph | inference-providers | plugin-api | plugin-sdk | storage | logging
plugins/     bundled Plugin packages and their packaging workspace
skills/      optional Built-in Agent Skills
tests/       LangGraph compatibility and protocol conformance

The production graph engine is isolated to packages/runtime-langgraph; frontends consume protocol projections rather than importing runtime or model bindings.

Documentation

Security and data

See SECURITY.md for the complete security model and vulnerability reporting process.

Contributors

Pizza Bot was designed, built, and brought into the open by its Executive Chefs and Sous Chefs:

Executive Chefs

Joseph Dolivo (@JoeDo) Igor Fil (@igorfil)

Sous Chefs

Flávio Schuindt (@flavioschuindt) Jacob Wert (@jwert-aws) Michael Karachewski (@michaelkarachewski) Itzik Paz (@spideron)

Pizza Bot was also shaped by more than 2,000 users across Amazon who tested earlier versions and shared feedback from real-world use. Their bug reports, ideas, and candid input helped make Pizza Bot ready for a broader community. Thank you to everyone who contributed.

License

Apache-2.0. See NOTICE for attribution notices.

pizza-bot (pizza-bot-app/pizza-bot)

Searching Database…

Что это такое?Открытый локальный «входящих»-почтовик для долгих задач AI-агентов, построенный на DeepAgents и LangGraph. Вы запускаете или планируете задачу, отходите от компьютера, а возвращаясь видите готовую работу в очереди Unread и решения, которые вас дожидаются, — в разделе Action.
Это настольное приложение или то, что открывается в браузере?И то, и другое, плюс CLI для терминала. Один «stateful»-рантайм DeepAgents/LangGraph отдаёт один и тот же интерфейс на React и в Electron, и в браузере, а десктопное приложение, веб-версия и CLI общаются с api-server по HTTP/SSE.
Как его запустить?Скачайте установщик со страницы релизов (.dmg/.zip для macOS, -setup.exe для Windows x64, .deb/.rpm для Linux) или запустите npm run dev с Node.js 24+. Затем перед первым реальным запуском настройте модель в разделе Settings > Providers.
Нужно ли подключать своего провайдера моделей или API-ключ?Да. Для работы api-server нужен хотя бы один провайдер — Amazon Bedrock, Anthropic, Google Gemini, OpenAI, OpenRouter или Ollama, — настроенный в разделе Settings > Providers; самим клиентам в браузере и CLI ничего из этого не требуется.
Что будет, если я закрою приложение, пока агент ещё работает над задачей?Задача продолжит выполняться: агенты работают дальше, даже если вы ушли со страницы или потеряли соединение, а чекпоинтированные запуски переживают отключение клиента. Обязан оставаться запущенным только процесс api-server, а триггеры cron или webhook могут вообще запустить работу без открытого диалога.
Это внутренний инструмент Amazon или им может пользоваться кто угодно?Кто угодно. Проект создан внутри Amazon, где ранние версии протестировали более 2 000 сотрудников, а сейчас он опубликован с открытым кодом под лицензией Apache 2.0 и с подписанными установщиками для macOS, Windows и Linux.
Куда попадают мои данные?По умолчанию они остаются локально: api-server слушает на 127.0.0.1, а треды, чекпоинты, воспоминания, вложения и логи лежат в ~/.pizza-bot-oss. За пределы машины уходят только запросы к провайдерам и эндпоинтам, которые вы настроили сами; привязка к адресам, отличным от loopback, требует аутентификации.
Как расширить его новыми инструментами или агентами?Добавьте MCP-серверы через интерфейс или файл .mcp.json, положите Agent Skills в папку /skills или установите плагины, в которых MCP-серверы и навыки уже собраны вместе. Навыки становятся субагентами, привязанными к инструментам, и их прогресс виден в панели Activity.
Может ли агент читать мои файлы?Только те папки, доступ к которым вы явно выдали в разделе Settings > Files, и каждая из них остаётся доступной только для чтения, пока вы не разрешите запись. Доступа к домашней папке по умолчанию нет, а на удалённой стороне разрешения указывают пути на машине с бэкендом.
Почему это «входящие», а не чат-приложение?Потому что результаты и решения складываются в очередь: выполненная работа попадает в Unread, запросы на подтверждение — в Action, а треды можно группировать по папкам, не скрывая подходящую работу из этих общих очередей.
Как хранятся мои API-ключи провайдеров?Десктопная версия защищает введённые секреты через Electron safeStorage, а конфигурация на стороне сервера сохраняет только ссылки на переменные окружения, а не сами ключи.
Size
11.4 MB
Stars
500
Age
3mo
Commits · 90 Days