Pizza Bot: 장시간 실행 AI 에이전트용 Apache 2.0 인박스

Pizza Bot은 Mac, Windows, Linux에서 자체 호스팅되는 데스크톱 앱으로, AI 에이전트를 백그라운드에서 실행하고 이메일 같은 UI로 보여줍니다. 완료된 작업은 Unread에 모이고, 승인을 기다리는 실행은 Action에 쌓입니다. Apache 2.0 라이선스이며 가입도, 텔레메트리도 없고, 원하는 모델 제공자를 직접 연결할 수 있습니다.

아키텍처

Pizza Bot은 서버와 클라이언트로 구성됩니다. 데스크톱 앱은 둘 다 번들하지만, 클라이언트를 원격 백엔드에 연결할 수도 있습니다. 제작자는 홈 네트워크에 서버를 자체 호스팅하고 Tailscale을 통해 휴대폰에서 접속합니다. 서버가 스레드 수명 주기를 관리하고 DeepAgents와 LangGraph로 상태를 체크포인트하며, 클라이언트는 필요할 때 서버에서 상태를 복원합니다. 즉, 실행 중 연결이 끊겨도 다른 클라이언트에서 이어서 진행할 수 있습니다. 승인 일시정지는 이를 생성한 세션보다 오래 유지되므로, 한 시간 뒤 다른 기기에서 응답할 수 있습니다.

통신 프로토콜은 HTTP/SSE입니다. 데스크톱 앱, 브라우저 앱, 터미널 CLI 모두 동일한 api-server와 통신합니다.

서브에이전트, 스킬, 메모리

대화하는 에이전트에는 샌드박스된 QuickJS 인터프리터가 있으며, 폴더 접근 권한을 부여한 경우에만 파일시스템에 접근할 수 있습니다.
각 서브에이전트는 스킬과 1:1로 매핑되며, Activity 바에서 작업 중인 서브에이전트와 도구 호출을 볼 수 있습니다.
스킬은 도구별 승인 정책을 가진 일반 SKILL.md 파일이므로, 코드 인터프리터가 필요 없는 기존 스킬도 그대로 작동해야 합니다.
메모리는 선택 사항이며 사용자 컴퓨터에 일반 마크다운 파일로 저장됩니다. 메모리 조회를 포함한 모든 도구 호출은 명시적으로 이루어집니다.
도구는 MCP 서버에서 가져옵니다.

설치

npm install
npm run build
npm run dev

Node.js 24 이상이 필요합니다. npm run dev는 Vite 프런트엔드와 Electron 셸을 시작하며, Electron 셸은 자체 api-server를 포크해 관리합니다. macOS(Intel 및 Apple silicon), Windows, Linux(x64 및 arm64)용 설치 프로그램이 모든 릴리스에 SHA256SUMS 파일과 함께 첨부됩니다. macOS 빌드는 서명 및 공증되며, Linux 패키지는 서명되지 않습니다.

실제 실행을 시작하기 전에 Settings > Providers에서 모델을 구성하세요. 지원 제공자: Amazon Bedrock, Anthropic, Google Gemini, OpenAI, OpenRouter, Ollama. Bedrock은 AWS 프로필, 액세스 키, 또는 Bedrock API 키와 선택적 리전 재정의를 허용합니다(기본값은 AWS_REGION 또는 us-west-2). OpenAI와 Anthropic 모두 사용자 지정 base URL을 허용하며, OpenAI는 Responses 또는 Chat Completions를 명시적으로 선택할 수 있고, Anthropic은 x-api-key 또는 bearer 인증을 지원합니다.

주의사항

이 프로젝트는 Amazon에서 만들어져 내부 사용자 2,000명 이상으로 성장했습니다. Amazon 자체 시스템용 내부 스킬 및 MCP 서버 카탈로그는 OSS 릴리스에 포함되지 않아, 그 빌드보다 기능이 얇습니다. AWS 서비스가 아닌 커뮤니티 프로젝트이므로 지원이나 SLA는 없습니다. 폴더는 Settings > Files에서 명시적으로 추가하며, 앱은 기본적으로 홈 디렉터리 접근 권한을 갖지 않습니다. 트리거는 cron 또는 webhook일 수 있어 대화를 열어두지 않아도 작업이 시작될 수 있습니다.

📖 Read the full source: HN LLM Tools