How aditya7j/tron works
Knowledge Galaxy combines a notes visualization and conversational assistant with voice-driven desktop controls. The main path is browser question → HTTP server → local-note recall or live web lookup → model answer, with the indexed corpus also feeding the galaxy viewer. Separate branches provide focus sessions, guarded tools, study workflows, and locally produced/published video. Several server subsystems are documented in the README but their implementation was not sampled, so those links cite the README rather than implying source-level inspection.
Main entry points: server.py Assistant Server · build.py Note Indexer · hands.py Tool Gate · broadcast.py Video Broadcaster
Components 21
Galaxy & Chat
- Galaxy Viewer
viewer/index.html - Assistant Server
server.py
Knowledge Pipeline
- Note Indexer
build.py - Ingest & Recall
ingest.py - Markdown Corpus
notes - Galaxy Graph Data
viewer/graph-data.js - Searchable Note Index
Assistant Runtime
- Web Lookup
search.py - Model Provider
Voice & Actions
- Focus Sessions
focus.py - Tool Gate
hands.py - Tool Actions
tools - Process Runner
tools/_proc.py - Speech Output
say.py - Voice Identification
voiceprint.py
Study & Media
- Study Engine
scholar.py - Study Tick
tools/study_tick.py - Video Director
director.py - Video Broadcaster
broadcast.py - Google API
google_api.py
Other components
- User
Connections 26
- User → Galaxy Viewer: opens
- User → Assistant Server: asks
- Galaxy Viewer → Assistant Server: sends chat
- Assistant Server → Galaxy Viewer: serves
- Note Indexer → Markdown Corpus: reads
- Note Indexer → Ingest & Recall: uses
build.py - Note Indexer → Galaxy Graph Data: generates
- Note Indexer → Searchable Note Index: generates
- Assistant Server → Note Indexer: runs if missing
- Assistant Server → Searchable Note Index: reloads
- Assistant Server → Ingest & Recall: recalls notes
- Assistant Server → Web Lookup: looks up web
- Assistant Server → Model Provider: requests answer
- Assistant Server → Focus Sessions: runs sessions
- Assistant Server → Tool Gate: routes tool requests
- Tool Gate → Tool Actions: dispatches
hands.py - Tool Gate → Google API: uses
hands.py - Tool Gate → Process Runner: runs subprocesses
tools/_proc.py - Focus Sessions → Process Runner: uses
focus.py - Assistant Server → Speech Output: speaks responses
- Assistant Server → Voice Identification: checks speaker
- Study Tick → Study Engine: runs study tick
tools/study_tick.py - Study Tick → Assistant Server: checks readiness
tools/study_tick.py - Video Director → Video Broadcaster: hands off films
broadcast.py - Video Broadcaster → Google API: uses API
broadcast.py - Video Broadcaster → Assistant Server: reads configuration
broadcast.py