A self-hosted, open-source personal AI agent with 9+ messaging channels, 6 agent backends, 50+ built-in tools, and a 7-layer security framework, featuring a native desktop app and web dashboard.
PocketPaw is a self-hosted AI agent platform running entirely on the user's machine. Built on an event-driven message bus architecture, all messaging channels feed into a unified AgentLoop that routes to configured agent backends. The project uses a dual-layer architecture: a Python backend (src/pocketpaw/) and a Tauri 2.0/SvelteKit desktop client, communicating via REST + WebSocket.
Core capabilities include: (1) Multi-channel messaging — 9+ channels (Web, Discord, Slack, WhatsApp, Telegram, etc.) sharing a single agent context; (2) Multi-backend switching — six backends (Claude Agent SDK, OpenAI Agents SDK, Google ADK, Codex CLI, OpenCode, Copilot SDK) implementing a unified AgentBackend protocol; (3) 50+ built-in tools — browser automation (Playwright), search, image generation, voice, OCR, and a Skills plugin system; (4) 7-layer security framework — end-to-end protection from Guardian AI review and injection scanning to tool policy tiers and encrypted credentials; (5) Command Center multi-agent orchestration — automatic task decomposition and parallel agent execution.
Distributed under the MIT license via PyPI (pip install pocketpaw), with native desktop installers for macOS/Windows/Linux and Docker Compose deployment. Currently in Beta with active development (1,041+ commits, 72 contributors, 2,900+ test cases), supporting fully offline operation via Ollama. Integrations cover Gmail, Calendar, Google Drive, Spotify, Reddit, and MCP server extension on select backends.
Installation
- Desktop app: download from GitHub Releases
- One-liner:
curl -fsSL https://pocketpaw.xyz/install.sh | sh - pip:
pip install pocketpaw && pocketpaw - Docker:
docker compose up -d(web dashboard atlocalhost:8888)
Configuration
- Main config:
~/.pocketpaw/config.json - Env vars:
POCKETPAW_prefix (e.g.,POCKETPAW_AGENT_BACKEND) - Web panel: Dashboard Settings page
Unconfirmed items: Some channels (Signal/Matrix/Teams/Google Chat) support status unverified; Copilot SDK backend lacks detailed docs; Mem0 semantic search has no benchmarks; REST API documentation not yet available.