Pi Bot guides
A 16-chapter manual covering setup, models, Bot teamwork, approvals, routines, connections, remote work, relay self-hosting, and ACP. Screenshots come from the running app using test or sample data.
Get started
-
Install Pi Bot and run your first task
Install Pi Bot on macOS, Windows, or Linux, configure a model, and run your first Bot task in a chosen folder. Follow the setup steps with screenshots.
-
Configure Ollama, local models, and API keys
Configure Ollama local models, OpenRouter, or your own API key in Pi Bot. Choose main and auxiliary models and troubleshoot connection and authentication issues.
-
Create Bots, assign roles, and manage memory
Create a Pi Bot, set its name and role, choose a model, and manage skills, permissions, and memory. Follow the interface steps to build a team of Bots.
-
Chats, topics, the Bot browser, and work receipts
Send messages, manage topics and attachments, and switch between Execute and Plan Only in Pi Bot. Follow the steps for background commands, the Bot browser, and work receipts.
Tasks, collaboration and approvals
-
Multi-Bot group chats, plans, and context handoffs
Create a multi-Bot group, choose members and a coordinator, review a plan, and follow task handoffs. Learn which group messages, inputs, and deliverables each Bot receives.
-
Working folders, code review, and file changes
Choose a working folder, inspect file diffs, request a code review from another Bot, and check isolated workspaces and merge approvals in Pi Bot.
-
Permissions, approvals, and activity logs
Understand Pi Bot tool permissions, approval cards, YOLO mode, and activity logs. Check authorization scope and actions that still require human confirmation.
-
Scheduled routines, folder triggers, and todos
Create scheduled routines, folder triggers, and connection-event tasks in Pi Bot. Configure output folders, try a run, manage todos, and inspect run history and results.
Connections and devices
-
Connect apps, MCP tools, skills, and knowledge bases
Add apps, MCP tools, skills, and knowledge bases from Pi Bot Connections. Manage access tokens and troubleshoot connection setup with interface steps and screenshots.
-
Android pairing, remote approvals, and offline use
Install and pair the Pi Bot Android app, view chats and tasks, handle remote approvals, configure offline replies, and revoke a device or remove pairing.
-
Use a Runner on another computer or server
Install and pair a Pi Bot Runner on another computer or server. Choose a working folder and check connection status, command output, and permission scope.
-
Advanced: use Pi Bot in an editor with ACP
Connect an ACP-compatible editor such as Zed to Pi Bot, choose a Bot, and handle command approvals. Check desktop app, connection, and permission requirements.
Maintenance and troubleshooting
-
Pi Bot frequently asked questions
Find answers about Pi Bot installation, models, API keys, Ollama, tool approvals, routines, and Android pairing, with troubleshooting steps and links to the relevant guides.
-
Updates, data storage, and issue reports
Check Pi Bot updates, find local data, export logs, and report issues. Follow the steps to check versions, storage locations, and privacy before sharing feedback.
-
Where your data goes: privacy and security
Learn where Pi Bot stores chats, files, memory, and keys, and what data goes to online models, phones, relays, and connected services. Review the privacy and security boundaries.
-
Advanced: self-host the relay
Understand Pi Bot relay self-hosting, Cloudflare configuration, pairing, and troubleshooting. Deployment requires access to the source code; check the availability notice first.