Pizza Bot organiza caixa de entrada local para agentes de longa duração

O que é o Pizza Bot

Pizza Bot é um projeto de código aberto apresentado como uma "caixa de entrada local" para tarefas de IA de longa duração. A proposta central é permitir que o usuário inicie ou agende uma tarefa, siga com o dia a dia e deixe o trabalho concluído se acumular em filas organizadas: resultados prontos vão para a fila Unread, enquanto execuções aguardando uma decisão humana ficam em Action. Os agentes continuam trabalhando mesmo quando o usuário navega para longe ou se desconecta, desde que o processo api-server permaneça em execução.

O projeto foi desenvolvido na Amazon e é liberado sob a licença Apache 2.0. Segundo o repositório, mais de 2.000 usuários da Amazon testaram versões anteriores e contribuíram com feedback antes do lançamento na comunidade.

Arquitetura e funcionamento

O runtime usa DeepAgents e LangGraph com estado, com a mesma experiência em React disponível no Electron (desktop) e no navegador. Três frontends - aplicativo desktop, aplicativo web e CLI de terminal - se comunicam com o api-server via HTTP/SSE. O repositório organiza o código em aplicativos (api-server em Hono, CLI, desktop-shell e web) e pacotes (core, runtime-langgraph, inference-providers, plugin-api, plugin-sdk, storage e logging). O motor de grafos de produção fica isolado em runtime-langgraph, e os frontends consomem projeções de protocolo em vez de importar o runtime ou vínculos de modelos diretamente.

Execuções com checkpoint sobrevivem a desconexões do cliente, e gatilhos de cron ou webhook podem iniciar trabalho sem uma conversa aberta. Conversas podem ser agrupadas em pastas sem ocultar o trabalho correspondente das filas globais. Skills viram subagentes com escopo de ferramentas, cujo progresso aparece em um painel de Activity.

Provedores de modelo e extensibilidade

O usuário traz o próprio provedor: Amazon Bedrock, Anthropic, Google Gemini, OpenAI, OpenRouter e Ollama são suportados. O Bedrock aceita perfil AWS, chaves de acesso ou uma Bedrock API key, com região opcional, e combina o catálogo nativo com o catálogo regional Mantle, roteando modelos pelo Converse, OpenAI Responses/Chat Completions ou Anthropic Messages conforme a família de API anunciada. OpenAI e Anthropic aceitam URLs base personalizadas. Segredos inseridos no desktop são protegidos pelo safeStorage do Electron; a configuração do servidor persiste apenas referências a variáveis de ambiente.

A extensão ocorre por servidores MCP adicionados pela interface ou por arquivo de configuração, e por Agent Skills sob o diretório de dados do projeto; plugins podem empacotar MCP e skills juntos. Uma skill personalizada pode substituir uma Built-in ou Plugin com o mesmo id sem modificar a original, e há um guia embutido (Pizza Bot Guide) que explica recursos e ajuda na configuração.

Segurança e dados locais

O api-server se vincula por padrão a 127.0.0.1; vínculos fora do loopback exigem autenticação e uma lista explícita de origens permitidas. Threads, checkpoints, memórias, anexos e logs ficam no diretório de dados local (por padrão ~/.pizza-bot-oss), e solicitações de modelo e ferramenta vão apenas aos provedores configurados. Pastas locais exigem concessão explícita em Settings > Files, são somente leitura por padrão, e o bot não recebe acesso padrão ao diretório home. O projeto alerta que comandos de servidores MCP e plugins podem executar com as permissões da conta do usuário, recomendando instalar apenas fontes confiáveis.

Distribuição

Instaladores para macOS (Intel e Apple silicon), Windows e Linux (x64 e arm64) acompanham cada release, com arquivo SHA256SUMS para verificação. Os builds macOS são assinados e notarizados; os pacotes Linux não são assinados, então a recomendação é conferir os checksums. Para rodar do código-fonte é necessário Node.js 24 ou mais recente, e um api-server em execução precisa de pelo menos um provedor de modelo configurado, enquanto clientes HTTP não precisam. O repositório registra, até a captura, 255 estrelas, 17 forks, 79 commits e licença Apache-2.0.