Buddy is a Python-based, local-first network of Hermes agents for voice-first task planning and memory, designed to operate on a single machine with a hub and multiple specialized agents.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Buddy is an external executive function for people with ADHD, implemented as a mesh of Hermes agents that run locally on hardware. It uses a hub to register and route between agents (Bookkeeper, Browser, Orchestrator, Builder, Repair) and tools, with a dashboard for memory and analytics. The system emphasizes autonomous agents that communicate via a single /ask contract and can delegate tasks among themselves.
How it works
- Each specialist is a Hermes agent with its own profile and tools; communication uses a POST /ask contract.
- Agents collaborate through MCP tools to delegating to peers when needed.
- Deterministic tools exist alongside agents; Toolsmith tools generate small HTTP-GET MCP servers attached to one agent.
- Routing is handled by a lightweight Router, which forwards uncertain requests to the appropriate agent or escalates to the Orchestrator.
- Memory is per-agent with a memory layer and a separate long-term store; an Audit agent logs actions for self-improvement.
Getting started
Quick start (macOS)
Prerequisites: Python 3.11 · Docker (Colima) · ffmpeg · a Telegram bot token · OpenAI + ElevenLabs API keys. cloudflared is optional and disabled by default.
cd telegram_voice
python3.11 -m venv .venv
.venv/bin/pip install -r requirements.txt
cp .env.example .env # fill in your keys — .env is gitignored
# stealth browser
colima start --cpu 2 --memory 4
docker run -d --name browser --restart unless-stopped \
-p 8080:8080 -p 5900:5900 psyb0t/stealthy-auto-browse
# create the per-agent Hermes brains (needs Hermes installed + OPENAI_API_KEY set)
.venv/bin/python setup_hermes_brains.py
# the whole stack: terra proxy + Hermes brains + private local hub + bot + agents
.venv/bin/python start_all_mac.py
# provision the ElevenLabs agent + its webhook tools
.venv/bin/python setup_elevenlabs.py "<the tunnel URL printed above>"
Open the authenticated local dashboard with .venv/bin/python open_dashboard.py.
Remote access is opt-in; read SECURITY.md before enabling it.
Traction
- Stars: 18
- Forks: 0
- Open issues: 5
Release history
- Releases: latest 0 — none
Caveats
- License: none listed
- Language: Python
- Created: 2026-07-11
- Last push: 2026-07-12