How aethelos/-reel-genius works
Reel Genius is a local content-to-knowledge application: users configure a vault and local model, run content pipelines, and receive Obsidian notes. The main documented workflow fetches Watch Later videos, downloads and transcribes audio, then generates linked Markdown reports. Separate synthesis and auto-definition workflows build on vault notes. The web app manages settings and runs pipelines; its excerpt shows subprocess streaming and scheduling, but not the complete script-dispatch mapping. README statements support the high-level workflow; source excerpts support the detailed processing and vault relationships.
Main entry points: main.py API and runner · yt_genius.py Watch Later pipeline · reel_genius.py Reels pipeline · synthesize.py Master synthesis
Components 15
Local app
- Web interface
app/static/index.html - API and runner
app/main.py - Settings
app/config.py
Content pipelines
- Watch Later pipeline
yt_genius.py - Reels pipeline
reel_genius.py - Collection discovery
discovery.py
Knowledge workflows
- Master synthesis
synthesize.py - Auto-definer
definer_agent.py
Local resources
- Obsidian vault
- Settings file
Other components
- User
- YouTube
- Ollama model
- Whisper
Connections 21
- User → Web interface: uses
README.md - Web interface → API and runner: requests
- API and runner → Settings: loads and saves
app/main.py - Settings → Settings file: reads and writes
app/config.py - API and runner → Watch Later pipeline: launches pipeline
- API and runner → Master synthesis: launches pipeline
- API and runner → Auto-definer: launches pipeline
- Watch Later pipeline → YouTube: fetches videos
yt_genius.py - Watch Later pipeline → Whisper: transcribes audio
yt_genius.py - Watch Later pipeline → Ollama model: analyzes content
yt_genius.py - Watch Later pipeline → Obsidian vault: writes reports
yt_genius.py - Reels pipeline → Instagram: fetches collection
reel_genius.py - Reels pipeline → Whisper: transcribes video
reel_genius.py - Reels pipeline → Ollama model: generates analysis
reel_genius.py - Reels pipeline → Obsidian vault: writes reports
reel_genius.py - Collection discovery → Instagram: lists collections
discovery.py - Master synthesis → Obsidian vault: reads reports
synthesize.py - Master synthesis → Ollama model: requests synthesis
synthesize.py - Master synthesis → Obsidian vault: writes strategy
synthesize.py - Auto-definer → Obsidian vault: scans terms and writes definitions
definer_agent.py - Auto-definer → Ollama model: requests definitions
definer_agent.py