Reese Pi

A reproducible, agent-first workstation.
One clone, one script — a fresh machine becomes a full Pi agent rig: verifier loop, Claude Code routing, Pi-to-Pi agent comms, browser control, memory/todo tools, and a production Telegram agent.

---

Why

Standing up a capable AI-agent workstation is fiddly and easy to get subtly wrong. Reese Pi captures a known-good agent stack as code — clone it on any machine and get the same models, extensions, launch commands, and a production-grade Telegram agent, reproducibly.

Highlights

• One-command install — scripts/install-workstation.sh pins and installs the full package set.
• Telegram Bridge — a production agentic assistant: local-Whisper voice, document intake, streaming HTML replies, scheduled autonomy, one-tap approval gates, and full CLI slash-command parity, with 143 tests. The standout component → apps/telegram-bridge.
• Verifier loop — agent output is checked before it is trusted.
• Model routing — Claude Code-backed models and xAI/Grok OAuth via the Pi model layer.
• Pi-to-Pi communication — agents coordinate locally.
• Browser Harness — web control for agents.
• Tools wired in — memory, todo, and ask-user-question.

Architecture

flowchart TB
  subgraph IF[Interfaces]
    TGUI[Telegram Bridge]
    CLI[Pi CLI]
    BROW[Browser Harness]
  end
  subgraph CORE[Pi Agent Core]
    MODELS[Model routing<br/>Claude Code · xAI OAuth]
    VERIFY[Verifier loop]
    P2P[Pi-to-Pi comms]
  end
  subgraph TOOLS[Tools]
    MEM[Memory]
    TODO[Todo]
    ASK[Ask-User]
    MCP[MCP adapters]
  end
  TGUI --> CORE
  CLI --> CORE
  BROW --> CORE
  CORE --> TOOLS

Loading

One-click install

git clone https://github.com/reesepj/reese-pi.git
cd reese-pi
bash scripts/install-workstation.sh

Installs and pins the current package set: pi-claude-cli, pi-xai-oauth, pi-mcp-adapter, @samfp/pi-memory, @juicesharp/rpiv-ask-user-question, @juicesharp/rpiv-todo, @llblab/pi-telegram, the Browser Harness, and local Pi-to-Pi extensions.

Repo layout

Path	What
apps/telegram-bridge	Production agentic Telegram assistant (voice, documents, scheduler, approvals)
scripts/	Install + workstation automation
extensions/	Local Pi-to-Pi communication extensions
ai_docs/	Provider, model, and setup documentation
apps/	Workstation apps

License

MIT