How ko3ak81/agent-second-brain-public works
Agent Second Brain is a Telegram personal-assistant bot that captures messages and media, turns them into vault knowledge and tasks/events, and provides conversational retrieval and scheduled reports. The graph combines README-documented product flows with source-index-supported wiring; unsampled handlers and services are represented only at the directory or subsystem level, so some internal links are intentionally omitted.
Main entry points: processor.py AI processing · main.py Bot runtime · commands.py Commands · handlers Message and media handlers
Components 31
Telegram capture
- Bot runtime
src/d_brain/bot/main.py - Commands
src/d_brain/bot/handlers/commands.py - Message and media handlers
src/d_brain/bot/handlers
Knowledge processing
- AI processing
src/d_brain/services/processor.py - Obsidian vault
src/d_brain/services/storage.py - File deduplication
src/d_brain/services/dedup_state.py - Voice transcription
src/d_brain/services/transcription.py - Context compression
src/d_brain/services/token_compression.py
Tasks and calendar
- Event callbacks
src/d_brain/bot/handlers/event_callback.py - Event parsing
src/d_brain/services/eventparse.py - Todoist tasks
src/d_brain/services/todoist.py - Google Calendar
src/d_brain/services/gcal.py
Scheduled services
- Reminder scheduler
src/d_brain/services/scheduler.py - Periodic job runner
src/d_brain/jobs/runner.py - Job registry
src/d_brain/jobs/__init__.py - Job contract
src/d_brain/jobs/base.py - Auto-fetch job
src/d_brain/jobs/autofetch_job.py - Gmail source
src/d_brain/services/autofetch/gmail.py - Memory rollups
src/d_brain/services/rollup.py - Memory fading
src/d_brain/services/hotness.py - Daily report
src/d_brain/bot/handlers/process.py
Persistence and settings
- Conversation history
src/d_brain/services/session.py - Pending event state
src/d_brain/services/pending_events.py - User preferences
src/d_brain/services/user_settings.py - Fetch cursors and budget
src/d_brain/services/autofetch/state.py - Application settings
src/d_brain/config.py - Processing quota
src/d_brain/services/quota_state.py - Processing history
src/d_brain/services/process_log.py
Other components
- Telegram user
- Telegram
- Deepgram
Connections 37
- Telegram user → Telegram: sends content
README.md - Telegram → Bot runtime: delivers updates
src/d_brain/bot/main.py - Bot runtime → Commands: registers router
src/d_brain/bot/main.py - Bot runtime → Message and media handlers: registers routers
src/d_brain/bot/main.py - Bot runtime → Event callbacks: registers router
src/d_brain/bot/main.py - Message and media handlers → AI processing: requests processing
src/d_brain/bot/handlers/process.py - Message and media handlers → Event parsing: extracts event intent
src/d_brain/bot/handlers/text.py - Message and media handlers → Voice transcription: transcribes voice
src/d_brain/bot/handlers/event_callback.py - Voice transcription → Deepgram: sends audio
README.md - Message and media handlers → Obsidian vault: saves captures
src/d_brain/bot/handlers/commands.py - Obsidian vault → File deduplication: checks duplicate
src/d_brain/services/storage.py - AI processing → Obsidian vault: classifies and files
README.md - AI processing → Todoist tasks: creates tasks
README.md - AI processing → Conversation history: loads session context
src/d_brain/services/processor.py - AI processing → Processing quota: tracks usage
src/d_brain/services/processor.py - AI processing → Processing history: records processing
src/d_brain/services/processor.py - AI processing → Context compression: compresses context
src/d_brain/services/processor.py - Commands → Todoist tasks: adds reminder
src/d_brain/bot/handlers/commands.py - Commands → Reminder scheduler: schedules chat ping
src/d_brain/bot/handlers/commands.py - Commands → Conversation history: records reminder
src/d_brain/bot/handlers/commands.py - Commands → User preferences: reads timezone
src/d_brain/bot/handlers/commands.py - Event callbacks → Pending event state: resolves pending event
src/d_brain/bot/handlers/event_callback.py - Event callbacks → Google Calendar: creates event
src/d_brain/bot/handlers/event_callback.py - Event callbacks → Obsidian vault: writes event card
README.md - Event callbacks → User preferences: reads timezone
src/d_brain/bot/handlers/event_callback.py - Bot runtime → Periodic job runner: starts runner
src/d_brain/bot/main.py - Periodic job runner → Job registry: runs registered jobs
src/d_brain/jobs/__init__.py - Job registry → Job contract: builds job list
src/d_brain/jobs/__init__.py - Job registry → Auto-fetch job: registers optional fetch
src/d_brain/jobs/__init__.py - Auto-fetch job → Gmail source: fetches mail
- Gmail source → Fetch cursors and budget: checks seen and budget
src/d_brain/services/autofetch/gmail.py - Auto-fetch job → Obsidian vault: files fetched items
- Job registry → Memory rollups: registers rollup
src/d_brain/jobs/__init__.py - Job registry → Memory fading: registers recompute
src/d_brain/jobs/__init__.py - Bot runtime → Daily report: registers processing route
src/d_brain/bot/main.py - Daily report → AI processing: runs processing
src/d_brain/bot/handlers/process.py - Application settings → Bot runtime: configures runtime
src/d_brain/__main__.py