Model Context Protocol (MCP)
Seamlessly extend agent capabilities by connecting standard MCP servers. Instantly query databases, local code indices, or external APIs.
Interactive Core Engine
Engineered for absolute autonomy.
Custom-PI is a self-evolving coding agent that never forgets, never stops, and operates entirely on local developer hardware with absolute privacy.
Ecosystem
A complete suite for builders.
Beyond coding, Custom-PI is packed with tools to automate your creative, social, and operational workflows securely on your local desktop.
Encrypted Secrets Vault
Securely stores API keys, database credentials, and SSH keys locally in an AES-256 encrypted SQLite database with master key authentication.
Browser Social Automation
Automates scheduling and publishing text, threads, and attachments directly to Twitter/X, Reddit, Bluesky, Discord, and Telegram using Playwright.
Canvas Suite & Doc Editor
Features an interactive canvas editor for images (filters, crops, adjustments) and a side-by-side markdown document editor with AI co-writing.
Free AI Image Generation
Built-in Pollinations.ai and local SD webui pipeline. Generates batches of image assets and previews them before executing blog or social deployments.
Budget & Token Analytics
Set hard spending limits for cloud LLM APIs. Track token consumption and real-time costs with automatic circuit-breaking caps.
100+
TypeScript Modules
80+
API Endpoints
406
Test Cases
30+
Prompt Templates
Pipeline
How Custom-PI operates.
An orchestration workflow that loops planning, reasoning, and tool execution to solve goals. Hover over each node to see its description.
Voice & Synthesis
Talk to your agent.
Hear it answer.
Custom-PI integrates with open-source TTS synthesis engines like Kokoro and Piper via a Python subprocess. Wake words let you control code swarms hands-free, while real-time synthesis delivers auditory status reports.
RachelKokoro
US Female
GeorgeKokoro
UK Male
AdamPiper
US Deep Male
NicolePiper
AU Female
TTS Synthesis Preview
Voice: Rachel • US Female
“Analyzing workspace. Ready to deploy the authentication changes.”
Setup Guide
Up and running in seconds.
A terminal-first installation process. Bring your own keys, connect your local repositories, and start building.
1
Install CLI package
Add custom-pi to your workspace or run it globally. Installs fastify server and client UI bundle.
2
Configure LLMs / Secrets
Plug in your Anthropic, OpenAI or Google API keys via vault, or launch completely offline using Ollama.
3
Launch Web Dashboard
Access 30+ interactive panels. Plan task queues, review edits, stream TTS voice, and publish posts.
Also Available as a Desktop App
Run Custom-PI as a native application
Standalone Electron app with system tray, auto-updates, and integrated web dashboard. No terminal required.
Engine Stack
Lightweight, robust engineering.
A technology selection built to run with maximum efficiency on local developer environments, ensuring 0% latency and 100% code security.
Node.js
Runtime EnvironmentRuns local server engines with filesystem I/O access.
React 19
Frontend UI RenderingPowers the responsive SPA dashboard and agent panels.
TypeScript
Type SafetyEnsures absolute code robustness across modules.
Fastify v5
Web Server REST APIHandles high-speed local HTTP routes and system endpoints.
SQLite
State Database EngineSaves vaults, settings, tasks, and memory graphs locally.
WebSocket
Real-time ChannelsStreams tokens, log outputs, and TTS voice packets.