How chandanhk304/athena works
Athena is a PMO intelligence application: enterprise-like project events enter through the simulator’s webhook dispatcher and Athena’s API, are indexed into graph and vector knowledge stores, and can be queried or analyzed by the agent workflow. The dashboard provides the user-facing interface; risk alerts and proposed write actions pass through a human-approval gate. The README documents broader capabilities such as synthesis, proactive risk detection, and stakeholder communication; some implementation details are unsampled, so those links are omitted where source evidence is unavailable.
Main entry points: athena_core/api.py Athena API · nodes.py Agent Nodes · webhook.py Webhook Dispatcher · simulator/api.py Simulator API
Components 20
Dashboard
- Next.js Dashboard
frontend/src/app/page.tsx - Dashboard API Client
frontend/src/lib/api.ts
Event Ingestion
- Athena API
athena_core/api.py - Event Pipeline
athena_core/ingestion.py
Knowledge Stores
- Graph Syncer
athena_core/graph_syncer.py - Vector Indexer
athena_core/vector_indexer.py - Neo4j Knowledge Graph
- Pinecone Vector Store
Agent Workflow
- LangGraph Orchestrator
agent_brain/graph.py - Agent Nodes
agent_brain/nodes.py - Agent State
agent_brain/state.py - Agent Tools
agent_brain/tools.py
Project Simulator
- Simulator API
simulator/api.py - Simulator Database
simulator/database.py - Chaos Engine
simulator/chaos_engine.py - Project Data Generator
simulator/data_gen.py - Timeline Simulator
simulator/timeline_sim.py - Webhook Dispatcher
simulator/webhook.py
Other components
- Program Manager
- LLM Provider
Connections 23
- Program Manager → Next.js Dashboard: uses
README.md - Next.js Dashboard → Athena API: requests data
README.md - Simulator API → Webhook Dispatcher: dispatches events
simulator/api.py - Chaos Engine → Webhook Dispatcher: notifies changes
- Timeline Simulator → Webhook Dispatcher: replays events
simulator/webhook.py - Timeline Simulator → Project Data Generator: uses
simulator/timeline_sim.py - Simulator API → Simulator Database: reads and writes
simulator/api.py - Simulator API → Chaos Engine: invokes
simulator/api.py - Chaos Engine → Project Data Generator: uses
simulator/chaos_engine.py - Webhook Dispatcher → Athena API: posts events
simulator/webhook.py - Athena API → Event Pipeline: processes events
athena_core/api.py - Event Pipeline → Graph Syncer: syncs entities
athena_core/ingestion.py - Event Pipeline → Vector Indexer: indexes events
athena_core/ingestion.py - Graph Syncer → Neo4j Knowledge Graph: writes graph
athena_core/graph_syncer.py - Vector Indexer → Pinecone Vector Store: indexes vectors
athena_core/vector_indexer.py - Athena API → LangGraph Orchestrator: invokes
athena_core/api.py - LangGraph Orchestrator → Agent Nodes: routes through
agent_brain/graph.py - Agent Nodes → Agent State: reads and updates
agent_brain/nodes.py - Agent Nodes → Agent Tools: calls tools
agent_brain/nodes.py - Agent Tools → Neo4j Knowledge Graph: queries graph
agent_brain/tools.py - Agent Tools → Pinecone Vector Store: searches vectors
agent_brain/tools.py - Agent Nodes → LLM Provider: requests inference
agent_brain/nodes.py - Program Manager → Athena API: approves actions
README.md