# pi-dispatch

> Self-hosted service running pi coding agent as background jobs with container isolation, spend caps, and admin panel.

- **Category:** AI
- **Licence:** MIT
- **Latest version:** admin-v4.3.1
- **Open source:** oss
- **Languages:** JavaScript, HTML
- **Platforms:** Podman, NPM, Systemd
- **Tags:** Automation, Chatgpt, Deepseek, Claude, Ai Tools, Gitlab, Podman, Docker, AI, Queue, Self Hosted, Valkey, Forgejo, Budget, Azure devops, Container isolation, Coding agent, Glm, Pi, GitHub, Kimi, Pi Extension, Spend Limits, Pi Package

## Description

pi-dispatch is a self-hosted service that runs the pi coding agent as background jobs. It accepts work from cron schedules, the command line, or events from four major code forges. Every job executes inside a throwaway Docker or Podman container that has no root access, no Linux capabilities, and a read-only instruction mount. Before any model call happens, the system checks turn limits, token budgets, and dollar caps set per day, week, or month. A Valkey queue handles durability and concurrency. Repositories can be grouped into projects that share a budget and get their own memory and CPU allocation. The admin interface loads as a pi extension and shows the live queue, budget breakdown, host capacity, and detailed cost analytics. Workflows are defined as pi skills — Markdown files stored in each repo under .pi/skills/. A separate receiver component ingests forge webhooks or can poll for events, so no public URL is required. The software runs on Linux servers, VMs, or developer machines with Docker Desktop, and multiple hosts can share one queue. It requires Node 22.19 or newer and a container runtime.

## Links

- [Homepage](https://github.com/edgehero/pi-dispatch)
- [GitHub Repository](https://github.com/edgehero/pi-dispatch)
- [npm: @edgehero/pi-dispatch](https://www.npmjs.com/package/@edgehero/pi-dispatch)
- [npm: @edgehero/pi-dispatch-receiver](https://www.npmjs.com/package/@edgehero/pi-dispatch-receiver)
- [npm: @edgehero/pi-dispatch-admin](https://www.npmjs.com/package/@edgehero/pi-dispatch-admin)

---
Source: https://selfhost.directory/project/pi-dispatch