How felsyn/felhaven works
Felhaven is a local-first Tk personal dashboard built from independent toolbox modules. The main workflow is a user question in the home chat, routed through Pythia to the local LLM and—when requested—tool handlers, then displayed and optionally narrated by Calliope. Kairos separately polls dashboard data workers and updates panels. The graph also preserves the README’s major view capabilities. Sampled excerpts are partial, so unsampled subsystem wiring is shown only where the README documents it.
Main entry points: tools Tool handlers · panels Dashboard views · pythia.py Pythia · home_panel.py Home chat
Components 20
Dashboard interface
- Felhaven app
metis_toolbox/felhaven.py - Home chat
metis_toolbox/panels/home_panel.py - Dashboard views
metis_toolbox/panels
Shared infrastructure
- Audio output
metis_toolbox/harmonia.py - Kairos workers
metis_toolbox/kairos.py - Secrets gate
metis_toolbox/cerberus.py
Assistant workflow
- Pythia
metis_toolbox/pythia.py - Tool handlers
metis_toolbox/tools - Calliope narration
metis_toolbox/calliope.py
Tool capabilities
- Weather
metis_toolbox/tools/aura.py - Sky and seasons
metis_toolbox/tools - Local chart
metis_toolbox/tools/artemis.py - Markets ledger
metis_toolbox/tools/midas.py - RSS news
metis_toolbox/tools/pheme.py - YouTube audio
metis_toolbox/tools/morpheus.py - Tasks and utilities
metis_toolbox/tools - Markdown archive
metis_toolbox/tools/herodotus.py - Web search
metis_toolbox/tools/callimachus.py
Other components
- User
- Ollama LLM
Connections 22
- User → Home chat: asks
- User → Dashboard views: selects view
- Felhaven app → Dashboard views: renders
- Home chat → Pythia: asks
- Pythia → Ollama LLM: sends chat
- Ollama LLM → Pythia: returns reply
- Pythia → Tool handlers: dispatches calls
- Tool handlers → Weather: handles
- Tool handlers → Sky and seasons: handles
- Tool handlers → Local chart: handles
- Tool handlers → Markets ledger: handles
- Tool handlers → RSS news: handles
- Tool handlers → YouTube audio: handles
- Tool handlers → Tasks and utilities: handles
- Tool handlers → Markdown archive: handles
- Tool handlers → Web search: handles
- Home chat → Calliope narration: requests speech
- Calliope narration → Audio output: sends PCM
- Kairos workers → Tool handlers: polls fetch
- Kairos workers → Dashboard views: updates panels
- Dashboard views → Secrets gate: gates secrets
- Dashboard views → Markets ledger: shows holdings