# siddheshg01/argos architecture

> Architecture diagram of the GitHub repository siddheshg01/argos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/siddheshg01/argos
- Repository: https://github.com/siddheshg01/argos

## Overview

This is a financial operations intelligence platform: it turns sales data into validated financial reports, root-cause findings, and forecasts, then offers analyst, policy-retrieval, multi-agent, and approval-gated workflow capabilities through a dashboard and API. The documented analytical workflow is represented alongside those product branches. Source excerpts show orchestration and selected integrations; links to unsampled subsystems are included only where the README or SOURCE INDEX supports them.

Main entry points: [`src/financial_intelligence/pipeline.py`](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/pipeline.py) (Financial pipeline), [`src/financial_intelligence/forecasting.py`](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/forecasting.py) (Financial forecasting), [`main.py`](https://github.com/siddheshg01/argos/blob/main/main.py) (CLI entry), [`src/financial_intelligence/rag/rag_pipeline.py`](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/rag/rag_pipeline.py) (Policy RAG pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Financial analysis"]
  node_entry["CLI entry<br/>[main.py]"]
  node_load["Dataset loader<br/>[loader.py]"]
  node_schema["Schema discovery<br/>[schema.py]"]
  node_validate["Data validation<br/>[validator.py]"]
  node_clean["Data cleaning<br/>[cleaner.py]"]
  node_features["Feature engineering<br/>[features.py]"]
  node_pipeline["Financial pipeline<br/>[pipeline.py]"]
  node_reports["Financial reports<br/>[report.py]"]
end

subgraph group_insight["Investigations and forecasts"]
  node_investigation["Root-cause analysis<br/>[investigation.py]"]
  node_forecast["Financial forecasting<br/>[forecasting.py]"]
  node_forecastmodels["Forecast models<br/>[forecast_models.py]"]
  node_forecastreports["Forecast reports<br/>[forecast_report.py]"]
end

subgraph group_intelligence["Analyst and agents"]
  node_analyst["LLM analyst<br/>[llm_analyst.py]"]
  node_prompts["Prompt construction<br/>[prompt_builder.py]"]
  node_orchestrator["Agent orchestrator<br/>[orchestrator.py]"]
  node_specialists["Specialist agents"]
  node_agentmodels["Agent messages<br/>[models.py]"]
end

subgraph group_policy["Policy retrieval"]
  node_rag["Policy RAG pipeline<br/>[rag_pipeline.py]"]
  node_documents["Policy documents<br/>[document_loader.py]"]
  node_chunker["Document chunking<br/>[chunker.py]"]
  node_embeddings["Gemini embeddings<br/>[embeddings.py]"]
  node_vectorstore[("Policy vector store<br/>[vector_store.py]")]
end

subgraph group_delivery["API and operations"]
  node_workflow["Workflow engine<br/>[workflow.py]"]
  node_approval["Approval controls<br/>[approval.py]"]
  node_actions["Action execution<br/>[actions.py]"]
  node_workflowstore[("Workflow state<br/>[workflow_store.py]")]
  node_api["FastAPI adapter<br/>[api.py]"]
  node_dashboard["Operations dashboard<br/>[App.jsx]"]
end

node_user(("Finance user"))
node_dataset["Sales dataset"]
node_gemini{{"Gemini service"}}

node_user -->|"runs analysis"| node_entry
node_dataset -->|"loads rows"| node_load
node_entry -->|"runs pipeline"| node_pipeline
node_pipeline -->|"loads data"| node_load
node_pipeline -->|"discovers columns"| node_schema
node_pipeline -->|"validates data"| node_validate
node_pipeline -->|"cleans rows"| node_clean
node_pipeline -->|"engineers features"| node_features
node_pipeline -->|"writes reports"| node_reports
node_entry -->|"runs investigation"| node_investigation
node_entry -->|"runs forecasts"| node_forecast
node_forecast -->|"loads dataset"| node_load
node_forecast -->|"discovers schema"| node_schema
node_forecast -->|"cleans data"| node_clean
node_forecast -->|"engineers features"| node_features
node_forecast -->|"evaluates candidates"| node_forecastmodels
node_forecast -->|"writes outputs"| node_forecastreports
node_entry -->|"runs analysis"| node_analyst
node_analyst -->|"builds prompts"| node_prompts
node_analyst -->|"requests generation"| node_gemini
node_entry -->|"runs policy query"| node_rag
node_rag -->|"loads documents"| node_documents
node_rag -->|"chunks documents"| node_chunker
node_rag -->|"creates embeddings"| node_embeddings
node_rag -->|"stores vectors"| node_vectorstore
node_embeddings -->|"requests vectors"| node_gemini
node_user -->|"uses dashboard"| node_dashboard
node_dashboard -->|"calls API"| node_api
node_api -->|"routes queries"| node_orchestrator
node_orchestrator -->|"dispatches requests"| node_specialists
node_orchestrator -->|"uses messages"| node_agentmodels
node_api -->|"routes analysis"| node_analyst
node_api -->|"routes policy queries"| node_rag
node_api -->|"routes workflows"| node_workflow
node_workflow -->|"requires approval"| node_approval
node_workflow -->|"executes actions"| node_actions
node_workflow -->|"persists state"| node_workflowstore
node_approval -->|"records approvals"| node_workflowstore

click node_entry "https://github.com/siddheshg01/argos/blob/main/main.py"
click node_load "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/loader.py"
click node_schema "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/schema.py"
click node_validate "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/validator.py"
click node_clean "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/cleaner.py"
click node_features "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/features.py"
click node_pipeline "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/pipeline.py"
click node_reports "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/report.py"
click node_investigation "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/investigation.py"
click node_forecast "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/forecasting.py"
click node_forecastmodels "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/forecast_models.py"
click node_forecastreports "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/forecast_report.py"
click node_analyst "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/llm_analyst.py"
click node_prompts "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/prompt_builder.py"
click node_orchestrator "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/agents/orchestrator.py"
click node_specialists "https://github.com/siddheshg01/argos/tree/main/src/financial_intelligence/agents"
click node_agentmodels "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/agents/models.py"
click node_rag "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/rag/rag_pipeline.py"
click node_documents "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/rag/document_loader.py"
click node_chunker "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/rag/chunker.py"
click node_embeddings "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/rag/embeddings.py"
click node_vectorstore "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/rag/vector_store.py"
click node_workflow "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/workflow.py"
click node_approval "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/approval.py"
click node_actions "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/actions.py"
click node_workflowstore "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/workflow_store.py"
click node_api "https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/api.py"
click node_dashboard "https://github.com/siddheshg01/argos/blob/main/web/src/App.jsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_load,node_schema,node_validate,node_clean,node_features,node_pipeline,node_reports,node_user toneBlue
class node_investigation,node_forecast,node_forecastmodels,node_forecastreports toneAmber
class node_analyst,node_prompts,node_orchestrator,node_specialists,node_agentmodels toneMint
class node_rag,node_documents,node_chunker,node_embeddings,node_vectorstore toneRose
class node_workflow,node_approval,node_actions,node_workflowstore,node_api,node_dashboard,node_dataset,node_gemini toneIndigo
```

## Components

### Financial analysis

- [CLI entry](https://github.com/siddheshg01/argos/blob/main/main.py): `main.py`
- [Dataset loader](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/loader.py): `src/financial_intelligence/loader.py`
- [Schema discovery](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/schema.py): `src/financial_intelligence/schema.py`
- [Data validation](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/validator.py): `src/financial_intelligence/validator.py`
- [Data cleaning](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/cleaner.py): `src/financial_intelligence/cleaner.py`
- [Feature engineering](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/features.py): `src/financial_intelligence/features.py`
- [Financial pipeline](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/pipeline.py): `src/financial_intelligence/pipeline.py`
- [Financial reports](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/report.py): `src/financial_intelligence/report.py`

### Investigations and forecasts

- [Root-cause analysis](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/investigation.py): `src/financial_intelligence/investigation.py`
- [Financial forecasting](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/forecasting.py): `src/financial_intelligence/forecasting.py`
- [Forecast models](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/forecast_models.py): `src/financial_intelligence/forecast_models.py`
- [Forecast reports](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/forecast_report.py): `src/financial_intelligence/forecast_report.py`

### Analyst and agents

- [LLM analyst](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/llm_analyst.py): `src/financial_intelligence/llm_analyst.py`
- [Prompt construction](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/prompt_builder.py): `src/financial_intelligence/prompt_builder.py`
- [Agent orchestrator](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/agents/orchestrator.py): `src/financial_intelligence/agents/orchestrator.py`
- [Specialist agents](https://github.com/siddheshg01/argos/tree/main/src/financial_intelligence/agents): `src/financial_intelligence/agents`
- [Agent messages](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/agents/models.py): `src/financial_intelligence/agents/models.py`

### Policy retrieval

- [Policy RAG pipeline](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/rag/rag_pipeline.py): `src/financial_intelligence/rag/rag_pipeline.py`
- [Policy documents](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/rag/document_loader.py): `src/financial_intelligence/rag/document_loader.py`
- [Document chunking](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/rag/chunker.py): `src/financial_intelligence/rag/chunker.py`
- [Gemini embeddings](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/rag/embeddings.py): `src/financial_intelligence/rag/embeddings.py`
- [Policy vector store](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/rag/vector_store.py): `src/financial_intelligence/rag/vector_store.py`

### API and operations

- [Workflow engine](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/workflow.py): `src/financial_intelligence/workflow.py`
- [Approval controls](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/approval.py): `src/financial_intelligence/approval.py`
- [Action execution](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/actions.py): `src/financial_intelligence/actions.py`
- [Workflow state](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/workflow_store.py): `src/financial_intelligence/workflow_store.py`
- [FastAPI adapter](https://github.com/siddheshg01/argos/blob/main/src/financial_intelligence/api.py): `src/financial_intelligence/api.py`
- [Operations dashboard](https://github.com/siddheshg01/argos/blob/main/web/src/App.jsx): `web/src/App.jsx`

### Other components

- **Finance user**
- **Sales dataset**
- **Gemini service**

## Connections

- Finance user → CLI entry: runs analysis (evidence: `README.md`)
- Sales dataset → Dataset loader: loads rows (evidence: `README.md`)
- CLI entry → Financial pipeline: runs pipeline (evidence: `main.py`)
- Financial pipeline → Dataset loader: loads data (evidence: `src/financial_intelligence/pipeline.py`)
- Financial pipeline → Schema discovery: discovers columns (evidence: `src/financial_intelligence/pipeline.py`)
- Financial pipeline → Data validation: validates data (evidence: `src/financial_intelligence/pipeline.py`)
- Financial pipeline → Data cleaning: cleans rows (evidence: `src/financial_intelligence/pipeline.py`)
- Financial pipeline → Feature engineering: engineers features (evidence: `src/financial_intelligence/pipeline.py`)
- Financial pipeline → Financial reports: writes reports (evidence: `src/financial_intelligence/pipeline.py`)
- CLI entry → Root-cause analysis: runs investigation (evidence: `main.py`)
- CLI entry → Financial forecasting: runs forecasts (evidence: `main.py`)
- Financial forecasting → Dataset loader: loads dataset (evidence: `src/financial_intelligence/forecasting.py`)
- Financial forecasting → Schema discovery: discovers schema (evidence: `src/financial_intelligence/forecasting.py`)
- Financial forecasting → Data cleaning: cleans data (evidence: `src/financial_intelligence/forecasting.py`)
- Financial forecasting → Feature engineering: engineers features (evidence: `src/financial_intelligence/forecasting.py`)
- Financial forecasting → Forecast models: evaluates candidates (evidence: `src/financial_intelligence/forecasting.py`)
- Financial forecasting → Forecast reports: writes outputs (evidence: `src/financial_intelligence/forecasting.py`)
- CLI entry → LLM analyst: runs analysis (evidence: `main.py`)
- LLM analyst → Prompt construction: builds prompts (evidence: `src/financial_intelligence/llm_analyst.py`)
- LLM analyst → Gemini service: requests generation (evidence: `src/financial_intelligence/llm_analyst.py`)
- CLI entry → Policy RAG pipeline: runs policy query (evidence: `main.py`)
- Policy RAG pipeline → Policy documents: loads documents (evidence: `src/financial_intelligence/rag/rag_pipeline.py`)
- Policy RAG pipeline → Document chunking: chunks documents (evidence: `src/financial_intelligence/rag/rag_pipeline.py`)
- Policy RAG pipeline → Gemini embeddings: creates embeddings (evidence: `src/financial_intelligence/rag/rag_pipeline.py`)
- Policy RAG pipeline → Policy vector store: stores vectors (evidence: `src/financial_intelligence/rag/rag_pipeline.py`)
- Gemini embeddings → Gemini service: requests vectors (evidence: `src/financial_intelligence/rag/embeddings.py`)
- Finance user → Operations dashboard: uses dashboard (evidence: `README.md`)
- Operations dashboard → FastAPI adapter: calls API (evidence: `README.md`)
- FastAPI adapter → Agent orchestrator: routes queries (evidence: `src/financial_intelligence/api.py`)
- Agent orchestrator → Specialist agents: dispatches requests (evidence: `src/financial_intelligence/agents/orchestrator.py`)
- Agent orchestrator → Agent messages: uses messages (evidence: `src/financial_intelligence/agents/orchestrator.py`)
- FastAPI adapter → LLM analyst: routes analysis (evidence: `src/financial_intelligence/api.py`)
- FastAPI adapter → Policy RAG pipeline: routes policy queries (evidence: `src/financial_intelligence/api.py`)
- FastAPI adapter → Workflow engine: routes workflows (evidence: `src/financial_intelligence/api.py`)
- Workflow engine → Approval controls: requires approval (evidence: `src/financial_intelligence/workflow.py`)
- Workflow engine → Action execution: executes actions (evidence: `src/financial_intelligence/workflow.py`)
- Workflow engine → Workflow state: persists state (evidence: `src/financial_intelligence/workflow.py`)
- Approval controls → Workflow state: records approvals (evidence: `src/financial_intelligence/approval.py`)
