PiBot
Health Warn
- License — License: Apache-2.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Warn
- process.env — Environment variable access in apps/browser-extension/scripts/probe.ts
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Open-source, local-first AI agent team for your desktop: multi-agent group chats, computer use, browser, MCP, routines and approvals. macOS, Windows, Linux + Android. Built on pi.
Pi Bot
An open-source, local-first AI agent team for your desktop. Named AI Bots work on your own
computer: chat with one or put several in a group chat, and they plan, run commands, edit files,
browse the web and use your computer, while every risky step waits for your approval. Runs on
macOS, Windows and Linux, with an Android app. Built on the pi
agent kernel.
▶ Watch the 60-second video · Download · User guide
Pi Bot is a desktop app in which a team of named Bots works on your own computer. You chat with a
Bot directly or put several in a group chat, give them a working folder, and they plan, run
commands, edit files and hand work to each other, while every risky step waits for your approval.
The "brain" runs on your machine too: chats, files, memory and keys stay local, and only the
model provider you choose sees the prompts you send.
Website and downloads: https://pibot.space · User guide: docs/guide
What it does
- Bots and roles. Create Bots with a name, a role (developer, researcher, writer, translator,
…), their own model, skills, permissions and memory. - Direct and group chats. A group has a coordinator that plans, hands steps to members and
collects the results; you confirm the plan before it runs. - Working folders and changes. Bots work inside folders you choose. Every change is listed,
reviewable and, on macOS, restorable from automatic checkpoints. - Approvals and permissions. Every tool call goes through one policy engine. Commands run in
a sandbox (@anthropic-ai/sandbox-runtime),
and approvals, commands and anything sent outward are written to an audit log. - Routines and to-dos. Scheduled, folder-triggered and connection-triggered tasks.
- Connections. Apps, MCP servers, skills and knowledge bases.
- Models. Local models through Ollama, OpenRouter, your own API keys, and supported
subscription sign-ins. - More devices, optional. An Android app, runners on other computers or servers, a relay you
can host yourself, and use from editors over ACP.
Pi Bot runs on macOS 13 Ventura or later, Windows 10 / 11 and 64-bit Linux. It has no telemetry,
and Pi Bot's own servers never receive your chats or files. Besides the model provider you choose,
it connects only for update checks, the websites and searches your Bots use, and features you turn
on (phone, runners, connections), each explained first. See
docs/privacy for every outbound connection.
Install
Download the desktop app from https://pibot.space, then follow
Getting started.
Build from source
Requirements: Node from .nvmrc and pnpm 12.
git clone https://github.com/w01fb0ss/PiBot.git
cd PiBot
nvm use
pnpm install
pnpm dev # start the desktop app in development
Set PIBOT_DATA_DIR to keep development data apart from an installed Pi Bot. Other commands:
| Command | Purpose |
|---|---|
pnpm check |
Frozen install, typecheck, lint, policy matrix and tests |
pnpm check:changed [base] |
The same checks limited to what changed |
pnpm verify |
check, build, renderer smoke test and the end-to-end acceptance suites |
pnpm build |
electron-vite build (no installer) |
Repository layout
| Path | Contents |
|---|---|
apps/desktop |
The Electron app (main process, renderer, packaging) |
apps/mobile |
The Android app (React Native + Expo) |
apps/relay |
The relay for phone and runner connections (Cloudflare Worker) |
apps/runner, apps/cli |
The headless runner and command-line entry |
apps/plugins |
Bundled plugins (MCP and/or skills) |
packages/teams/builtin |
The roles and groups bundled for offline use; the full role library is pibot-roles |
packages/* |
The brain and its capabilities, in five layers; see AGENTS.md |
docs/guide, docs/privacy |
User guide and outbound-connection notes |
tests, tools |
End-to-end suites, the fake model and development tools |
The agent kernel is pi, pinned as an npm dependency and
used only in packages/agent. The brain does not depend on Electron, so the same code runs
headless.
Contributing
Issues and pull requests are welcome. Please read CONTRIBUTING.md and the rules
in AGENTS.md first; report security problems as described in
SECURITY.md, not in public issues.
License
Apache License 2.0. See NOTICE and
THIRD_PARTY_NOTICES for attributions.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found
