How schwarzilukas/braindump-butler works
BrainDump Butler is a PWA-backed assistant that turns raw notes into structured Obsidian Markdown, enriches them with tags and links, and saves them to a vault. Its main workflow runs through the notes API and skill orchestrator, then writes and indexes the note and commits it to Git. Separate API branches support refinement, templates, knowledge management, model selection, and manual sync. The README documents these capabilities; some implementation details are inferred only from the source index, so unsampled relationships are omitted.
Main entry points: orchestrator.py Skill orchestrator · main.py FastAPI app · notes.py Notes API · git_sync.py Git sync
Components 25
PWA client
- Web app
frontend/static/app.js
API and routing
- FastAPI app
backend/main.py - Notes API
backend/api/notes.py - Refine API
backend/api/refine.py - Templates API
backend/api/templates.py - Knowledge API
backend/api/knowledge.py - Sync API
backend/api/sync.py - Models API
backend/api/models.py - Note schemas
backend/models/schemas.py
AI processing
- Skill orchestrator
backend/skills/orchestrator.py - Intake skill
backend/skills/intake.py - Clarify skill
backend/skills/clarify.py - Structure skill
backend/skills/structure.py - Tag skill
backend/skills/tag.py - Link skill
backend/skills/link.py - Refine skill
backend/skills/refine.py
Vault and persistence
- Knowledge base
backend/knowledge/context.py - Vault index
backend/services/vault_index.py - Vault writer
backend/services/vault_writer.py - Git sync
backend/services/git_sync.py
Supporting features
- Template service
backend/services/template_service.py - AI processor
backend/services/ai_processor.py
Other components
- Note taker
- Copilot SDK
- Obsidian vault
Connections 34
- Note taker → Web app: enters notes
README.md - Web app → FastAPI app: uses API
README.md - FastAPI app → Notes API: routes requests
backend/main.py - FastAPI app → Refine API: routes requests
backend/main.py - FastAPI app → Templates API: routes requests
backend/main.py - FastAPI app → Knowledge API: routes requests
backend/main.py - FastAPI app → Sync API: routes requests
backend/main.py - FastAPI app → Models API: routes requests
backend/main.py - Notes API → Skill orchestrator: processes note
backend/api/notes.py - Notes API → Note schemas: validates data
backend/api/notes.py - Skill orchestrator → Intake skill: runs
backend/skills/orchestrator.py - Skill orchestrator → Clarify skill: may run
backend/skills/orchestrator.py - Skill orchestrator → Structure skill: runs
backend/skills/orchestrator.py - Skill orchestrator → Tag skill: runs parallel
backend/skills/orchestrator.py - Skill orchestrator → Link skill: runs parallel
backend/skills/orchestrator.py - Skill orchestrator → Refine skill: runs sessions
backend/skills/orchestrator.py - Skill orchestrator → Knowledge base: loads and updates
backend/skills/orchestrator.py - Skill orchestrator → Vault index: loads context
backend/skills/orchestrator.py - Structure skill → Template service: gets template
backend/skills/structure.py - Notes API → Vault writer: writes note
backend/api/notes.py - Notes API → Vault index: updates index
backend/api/notes.py - Notes API → Git sync: commits note
backend/api/notes.py - Vault writer → Obsidian vault: writes Markdown
README.md - Vault index → Obsidian vault: indexes notes
backend/services/vault_index.py - Git sync → Obsidian vault: commits changes
backend/services/git_sync.py - Refine API → Skill orchestrator: starts sessions
backend/api/refine.py - Templates API → Template service: manages templates
backend/api/templates.py - Knowledge API → Knowledge base: reads and updates
backend/api/knowledge.py - Sync API → Git sync: controls sync
backend/api/sync.py - Models API → Copilot SDK: lists models
- Git sync → Obsidian vault: pushes and pulls
README.md - Skill orchestrator → Copilot SDK: uses AI skills
- AI processor → Knowledge base: uses context
backend/services/ai_processor.py - AI processor → Note schemas: uses schemas
backend/services/ai_processor.py