How bpdeepak/athena works
Project Athena combines enterprise-event ingestion and knowledge indexing with a LangGraph PMO assistant, simulator, and dashboard. The documented user workflow is a dashboard query or incoming webhook through backend processing to knowledge-backed analysis and risk/approval actions. The graph preserves the simulator and dashboard capabilities; source excerpts are partial, so unshown wiring is included only where README or SOURCE INDEX references support it.
Main entry points: nodes.py Agent Nodes · athena_core/api.py FastAPI Core · simulator/api.py Simulator API · ingestion.py Event Ingestion
Components 28
Dashboard
- PMO Dashboard
frontend/app/page.tsx - Chat Panel
frontend/components/dashboard/chat-panel.tsx - Portfolio Views
frontend/components/dashboard/risk-feed.tsx - API Client
frontend/lib/api.ts
Core Data Services
- FastAPI Core
athena_core/api.py - Event Ingestion
athena_core/ingestion.py - Graph Syncer
athena_core/graph_syncer.py - Vector Indexer
athena_core/vector_indexer.py - Risk Cache
athena_core/cache.py - Core Configuration
athena_core/config.py
Agent Brain
- LangGraph Workflow
agent_brain/graph.py - Query Router
agent_brain/router.py - Agent Nodes
agent_brain/nodes.py - Agent State
agent_brain/state.py - Chat Memory
agent_brain/memory_manager.py - LLM Balancer
agent_brain/llm_balancer.py - Jira Tools
agent_brain/tools/jira_tools.py - PMO Analytics
agent_brain/tools/pmo_tools.py - Notifications
agent_brain/tools/notifications.py
Project Universe
- Simulator API
simulator/api.py - Simulator Database
simulator/database.py - Chaos Engine
simulator/chaos_engine.py - Webhook Dispatcher
simulator/webhook.py
Other components
- Program Manager
- Neo4j Graph
- Pinecone Vectors
- LLM Provider
- Stakeholders
Connections 30
- Program Manager → PMO Dashboard: uses
- PMO Dashboard → Chat Panel: presents
frontend/app/page.tsx - PMO Dashboard → Portfolio Views: presents
frontend/app/page.tsx - Chat Panel → API Client: requests
- API Client → FastAPI Core: calls
- FastAPI Core → Event Ingestion: routes events
athena_core/api.py - Event Ingestion → Graph Syncer: syncs entities
athena_core/ingestion.py - Event Ingestion → Vector Indexer: indexes text
athena_core/ingestion.py - Event Ingestion → Risk Cache: checks risks
athena_core/ingestion.py - Graph Syncer → Neo4j Graph: writes graph
- Vector Indexer → Pinecone Vectors: upserts vectors
- FastAPI Core → LangGraph Workflow: orchestrates
athena_core/api.py - LangGraph Workflow → Query Router: dispatches
agent_brain/graph.py - LangGraph Workflow → Agent Nodes: runs nodes
agent_brain/graph.py - LangGraph Workflow → Agent State: uses state
agent_brain/graph.py - Agent Nodes → Chat Memory: compresses history
agent_brain/nodes.py - Agent Nodes → LLM Balancer: invokes models
agent_brain/nodes.py - Chat Memory → LLM Balancer: summarizes with
agent_brain/memory_manager.py - Agent Nodes → Jira Tools: invokes tools
agent_brain/nodes.py - Agent Nodes → PMO Analytics: invokes tools
agent_brain/nodes.py - Agent Nodes → Notifications: uses tools
agent_brain/nodes.py - PMO Analytics → FastAPI Core: queries analytics
agent_brain/tools/pmo_tools.py - LLM Balancer → LLM Provider: routes inference
- FastAPI Core → Simulator API: simulator integration
- Simulator API → Simulator Database: reads and writes
simulator/api.py - Simulator API → Chaos Engine: dispatches faults
simulator/api.py - Simulator API → Webhook Dispatcher: dispatches events
simulator/api.py - Chaos Engine → Simulator API: injects faults
simulator/chaos_engine.py - Webhook Dispatcher → FastAPI Core: pushes events
- Agent Nodes → Stakeholders: notifies after approval