git404hub

what is buddy fr?

jamesbrownvc/buddy — explained in plain English

Analysis updated 2026-05-18

18PythonAudience · generalComplexity · 5/5Setup · hard

tl;dr

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.

vibe map

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

VIBE 4

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

what's the stack?

PythonFastAPIElevenLabsHermesMCPDocker

how it stacks up fr

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 i run it?

Difficulty · hard time til it works · 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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.