How yashsinghrawat/athena works
ATHENA is a text-based longitudinal state analysis tool, not a chatbot or diagnostic system. Its main workflow accepts a journal entry through the CLI, extracts a validated emotional and behavioral snapshot, embeds the text, and stores the entry; CLI commands then retrieve history for baseline comparisons or trajectories. The graph also shows configuration and SQLite persistence as internal layers. Demo data and the separate demo display are peripheral to the documented core workflow. Edges reflect the README and sampled source; unsampled subsystems are not inferred.
Main entry points: main.py Command workflow · storage.py Storage interface · config.py Runtime settings · emotion_engine.py State extraction
Components 9
CLI interface
- Command workflow
src/main.py
State analysis
- State extraction
src/emotion_engine.py - State validation
src/schemas.py - Text embedding
src/embedding_engine.py - Temporal analysis
src/temporal_engine.py
Semantic memory
- Storage interface
src/storage.py - SQLite entries
src/storage.py
Core foundation
- Runtime settings
src/config.py
Other components
- CLI user
Connections 14
- CLI user → Command workflow: submits or queries
README.md - Command workflow → State extraction: analyzes text
src/main.py - State extraction → State validation: validates state
src/emotion_engine.py - Command workflow → Text embedding: embeds text
src/main.py - Command workflow → Storage interface: saves entry
src/main.py - Storage interface → SQLite entries: writes entries
src/storage.py - Storage interface → SQLite entries: reads history
src/storage.py - Command workflow → Storage interface: retrieves history
src/main.py - Command workflow → Temporal analysis: compares baseline
src/main.py - Command workflow → Temporal analysis: gets trajectory
src/main.py - State extraction → Runtime settings: uses model settings
src/emotion_engine.py - Storage interface → Runtime settings: uses database path
src/storage.py - Temporal analysis → Runtime settings: uses state dimensions
src/temporal_engine.py - Command workflow → Runtime settings: uses state dimensions
src/main.py