How maysamsgx/fagenllm_2026_semmmrr works
FAgentLLM is a finance intelligence application with a React dashboard and a FastAPI/LangGraph backend. Users inspect finance domains, submit or process invoices, run reconciliation and related assessments, and review governed decisions and their traces. The backend routes domain requests into a shared multi-agent graph, which coordinates specialized agents and persists decisions and causal links. The README documents additional OCR, memory, evaluation, and dispute-resolution capabilities; these are included where the tree supports them. Some frontend-to-backend endpoint mappings and unsampled subsystem internals are not verified, so those links are dashed.
Main entry points: graph.py Agent Graph · App.tsx Dashboard Shell · api.ts API Client · supabase_client.py Supabase Data Access
Components 28
Finance Dashboard
- Dashboard Shell
App.tsx - Invoice Workspace
components/InvoiceView.tsx - Reconciliation Workspace
components/ReconciliationView.tsx - Cash and Budget
components/CashView.tsx - Credit and Disputes
components/CreditView.tsx - Evaluation Dashboard
components/EvaluationView.tsx - Governance Workspace
components/GovernanceView.tsx - Decision Traces
components/TracePanel.tsx - API Client
lib/api.ts - Realtime Updates
lib/useRealtime.ts
API Routing
- FastAPI Application
main.py - Invoice Routes
orchestration/routers/invoice.py - Finance Domain Routes
orchestration/routers - Governance Routes
orchestration/routers/governance.py
Finance Agents
- Agent Graph
orchestration/agents/graph.py - Shared Financial State
orchestration/agents/state.py - Invoice Agent
orchestration/agents/invoice_agent.py - Budget and Cash Agents
orchestration/agents - Reconciliation Agent
orchestration/agents/reconciliation_agent.py - Credit Agent
orchestration/agents/credit_agent.py - Governance Auditor
orchestration/agents/governance_agent.py
Reasoning Controls
- Policies and Prompts
directive/policies.py - LLM and OCR Services
execution/llm.py
Data and Evaluation
- Supabase Data Access
execution/db/supabase_client.py - Supabase Database
config.py - Evaluation Metrics
evaluation/evaluator.py
Other components
- Finance User
- LLM and OCR Providers
Connections 41
- Finance User → Dashboard Shell: uses
App.tsx - Dashboard Shell → Invoice Workspace: renders
App.tsx - Dashboard Shell → Cash and Budget: renders
App.tsx - Dashboard Shell → Reconciliation Workspace: renders
App.tsx - Dashboard Shell → Credit and Disputes: renders
App.tsx - Dashboard Shell → Evaluation Dashboard: renders
App.tsx - Dashboard Shell → Governance Workspace: renders
App.tsx - Invoice Workspace → API Client: requests
components/InvoiceView.tsx - Reconciliation Workspace → API Client: requests
components/ReconciliationView.tsx - Cash and Budget → API Client: requests
components/CashView.tsx - Credit and Disputes → API Client: requests
components/CreditView.tsx - Evaluation Dashboard → API Client: requests
components/EvaluationView.tsx - Credit and Disputes → Decision Traces: uses
components/CreditView.tsx - Reconciliation Workspace → Decision Traces: uses
components/ReconciliationView.tsx - Invoice Workspace → Decision Traces: uses
components/InvoiceView.tsx - API Client → Invoice Routes: HTTP requests
- API Client → Finance Domain Routes: HTTP requests
- FastAPI Application → Invoice Routes: registers
main.py - FastAPI Application → Finance Domain Routes: registers
main.py - FastAPI Application → Governance Routes: registers
main.py - Invoice Routes → Agent Graph: invokes
orchestration/routers/invoice.py - Finance Domain Routes → Agent Graph: invokes
orchestration/routers/budget.py - Agent Graph → Invoice Agent: dispatches
orchestration/agents/graph.py - Agent Graph → Budget and Cash Agents: dispatches
orchestration/agents/graph.py - Agent Graph → Reconciliation Agent: dispatches
orchestration/agents/graph.py - Agent Graph → Credit Agent: dispatches
orchestration/agents/graph.py - Agent Graph → Governance Auditor: dispatches
orchestration/agents/graph.py - Agent Graph → Shared Financial State: routes with
orchestration/agents/graph.py - Invoice Agent → Supabase Data Access: reads and writes
orchestration/agents/invoice_agent.py - Budget and Cash Agents → Supabase Data Access: reads and writes
orchestration/agents/cash_agent.py - Reconciliation Agent → Supabase Data Access: reads and writes
orchestration/agents/reconciliation_agent.py - Invoice Agent → Policies and Prompts: uses policies
orchestration/agents/invoice_agent.py - Budget and Cash Agents → Policies and Prompts: uses policies
orchestration/agents/cash_agent.py - Invoice Agent → LLM and OCR Services: calls
orchestration/agents/invoice_agent.py - Reconciliation Agent → LLM and OCR Services: calls
orchestration/agents/reconciliation_agent.py - LLM and OCR Services → LLM and OCR Providers: requests inference
- Supabase Data Access → Supabase Database: queries
execution/db/supabase_client.py - Realtime Updates → Supabase Database: subscribes
lib/useRealtime.ts - Evaluation Metrics → Agent Graph: evaluates
evaluation/evaluator.py - Evaluation Metrics → Supabase Data Access: reads data
evaluation/evaluator.py - Governance Routes → Supabase Data Access: reads data
orchestration/routers/governance.py