explaingit

jamesbrownvc/buddy

Analysis updated 2026-05-18

18PythonAudience · generalComplexity · 5/5Setup · hard

TLDR

A voice first network of autonomous agents built to act as an external executive function for people with ADHD, remembering tasks and nudging follow-through.

Mindmap

mindmap
  root((Buddy))
    What it does
      Remembers tasks by voice
      Breaks tasks into steps
      Nudges without shame
    Tech stack
      Python
      FastAPI
      Hermes agents
      ElevenLabs
    Agents
      Bookkeeper
      Browser agent
      Orchestrator
    Use cases
      ADHD support
      Voice task capture
      Multi agent delegation

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Capture tasks and reminders through a phone call or Telegram voice note instead of a to-do app.

USE CASE 2

Get a task automatically broken down into one small next physical step to reduce start-up friction.

USE CASE 3

Have specialist agents handle browsing, bookkeeping, and multi-step planning behind one voice interface.

USE CASE 4

Watch the live agent network, memory, and productivity trends through the included dashboard.

What is it built with?

PythonFastAPIElevenLabsHermesMCPDocker

How does it compare?

jamesbrownvc/buddy1038lab/comfyui-agnes-aiandyuneducated/resolve-ai
Stars181818
LanguagePythonPythonPython
Setup difficultyhardeasyhard
Complexity5/52/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Runs a full local mesh of agents, a hub, and a containerized browser, requiring several services set up on local hardware.

In plain English

Buddy is a voice first productivity system built for people with ADHD, framed as an external executive function rather than a normal to-do app. The README explains that ADHD is not a knowledge problem: people usually know what they should do, but struggle with actually starting tasks, holding a plan in working memory, judging how much time has passed, and following through without shame when something slips. Ordinary productivity tools assume the exact abilities ADHD affects, which is why they tend to get abandoned. Buddy's approach is to live where the user already is, such as a phone call or a Telegram voice note, capture whatever is said in loose half sentences, hold the plan on the user's behalf, break tasks down into one small physical next step, nudge at the moment action is actually needed, and treat a missed task as information rather than a failure. Under the hood, Buddy is a network of small, single purpose agents connected to one central hub, running entirely on local hardware. Every agent exposes the same simple contract, accepting a message and returning a reply, which lets agents call each other freely. A voice agent built on ElevenLabs, playing the role of an evidence based ADHD companion, can hand off parts of a conversation to any of the other specialist agents mid call. Those specialists include a bookkeeper agent that manages the user's memory, a browser agent that drives a real browser to complete web tasks, and an orchestrator that routes larger multi step requests to planning and building agents. Each specialist runs as its own independent autonomous agent with its own persona and tools, rather than following hard coded logic written in Python, and agents decide for themselves when to delegate work to a peer over these tool based connections. A dashboard shows the live network of agents, weekly productivity trends, and lets a user click into any agent to see its documentation, memory, or live browser session. The project won the Hermes Buildathon in 2026.

Copy-paste prompts

Prompt 1
Explain how Buddy's agents decide when to delegate a task to another specialist agent.
Prompt 2
Help me understand how the bookkeeper agent tracks and recalls tasks over time.
Prompt 3
Show me how the ElevenLabs voice agent connects to the Hub and its specialist agents.
Prompt 4
Walk me through the architecture diagram so I understand each agent's role in Buddy.

Frequently asked questions

What is buddy?

A voice first network of autonomous agents built to act as an external executive function for people with ADHD, remembering tasks and nudging follow-through.

What language is buddy written in?

Mainly Python. The stack also includes Python, FastAPI, ElevenLabs.

How hard is buddy to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is buddy for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.