# itaygenkin/tradingagency architecture

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

- Interactive diagram: https://gitdiagram.com/itaygenkin/tradingagency
- Repository: https://github.com/itaygenkin/tradingagency

## Overview

AI Trading Agent runs a morning market-analysis workflow and an evening accuracy audit. The morning process checks market availability, gathers pre-market prices and news, generates a Gemini-backed report and stores predictions; after close, pending predictions are compared with observed performance and persisted. Celery distributes per-ticker audit work through Redis. The graph preserves documented integrations and the major domain stages; details of the read-but-unsampled day and night pipeline implementations are limited to the README and SOURCE INDEX references.

Main entry points: [`src/trading_agency/application/day_analysis.py`](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/application/day_analysis.py) (Day Pipeline), [`src/trading_agency/application/celery_tasks.py`](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/application/celery_tasks.py) (Audit Tasks), [`src/trading_agency/infrastructure/market_provider.py`](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/infrastructure/market_provider.py) (Market Provider), [`src/trading_agency/application/night_audit.py`](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/application/night_audit.py) (Night Audit)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Morning Analysis"]
  node_day["Day Pipeline<br/>[day_analysis.py]"]
end

subgraph group_audit["Evening Audit"]
  node_night["Night Audit<br/>[night_audit.py]"]
  node_tasks["Audit Tasks<br/>[celery_tasks.py]"]
  node_validator["Performance Validator<br/>[audit_service.py]"]
  node_celery["Celery App<br/>[celery_app.py]"]
end

subgraph group_integrations["Data and AI"]
  node_market["Market Provider<br/>[market_provider.py]"]
  node_analyst["Market Analyst<br/>[llm_engine.py]"]
  node_model_factory["LLM Factory<br/>[llm_factory.py]"]
end

subgraph group_core["Domain and Storage"]
  node_report["Report Files<br/>[utils.py]"]
  node_models["Trading Models<br/>[models.py]"]
  node_repository["Market Repository<br/>[repository.py]"]
  node_results["Result Types<br/>[result.py]"]
end

node_operator(("Operator"))
node_gemini{{"Gemini LLM"}}
node_market_data{{"Market Data"}}
node_news{{"News Search"}}
node_postgres[("PostgreSQL")]
node_redis["Redis Broker"]

node_operator -->|"starts"| node_day
node_operator -->|"starts"| node_night
node_day -->|"gets market data"| node_market
node_day -->|"requests analysis"| node_analyst
node_day -->|"saves report"| node_report
node_day -->|"stores predictions"| node_repository
node_market -->|"fetches prices"| node_market_data
node_market -->|"searches news"| node_news
node_analyst -->|"gets model"| node_model_factory
node_model_factory -->|"provides model"| node_gemini
node_analyst -->|"invokes model"| node_gemini
node_day -->|"uses snapshots"| node_models
node_repository -->|"reads and writes"| node_postgres
node_night -->|"loads predictions"| node_repository
node_night -->|"gets performance"| node_market
node_night -->|"dispatches audits"| node_tasks
node_tasks -->|"gets performance"| node_market
node_tasks -->|"evaluates prediction"| node_validator
node_tasks -->|"updates results"| node_repository
node_validator -->|"invokes LLM"| node_analyst
node_validator -->|"returns evaluation"| node_results
node_tasks -->|"registers task"| node_celery
node_celery -->|"uses broker"| node_redis

click node_day "https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/application/day_analysis.py"
click node_market "https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/infrastructure/market_provider.py"
click node_analyst "https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/infrastructure/llm_engine.py"
click node_model_factory "https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/infrastructure/llm_factory.py"
click node_report "https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/utils/utils.py"
click node_models "https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/domain/models.py"
click node_repository "https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/infrastructure/repository.py"
click node_night "https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/application/night_audit.py"
click node_tasks "https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/application/celery_tasks.py"
click node_validator "https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/application/audit_service.py"
click node_results "https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/domain/result.py"
click node_celery "https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/celery_app.py"

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_day toneBlue
class node_night,node_tasks,node_validator,node_celery,node_postgres,node_redis toneAmber
class node_market,node_analyst,node_model_factory toneMint
class node_report,node_models,node_repository,node_results toneRose
class node_operator,node_gemini,node_market_data,node_news toneIndigo
```

## Components

### Morning Analysis

- [Day Pipeline](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/application/day_analysis.py): `src/trading_agency/application/day_analysis.py`

### Evening Audit

- [Night Audit](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/application/night_audit.py): `src/trading_agency/application/night_audit.py`
- [Audit Tasks](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/application/celery_tasks.py): `src/trading_agency/application/celery_tasks.py`
- [Performance Validator](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/application/audit_service.py): `src/trading_agency/application/audit_service.py`
- [Celery App](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/celery_app.py): `src/trading_agency/celery_app.py`

### Data and AI

- [Market Provider](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/infrastructure/market_provider.py): `src/trading_agency/infrastructure/market_provider.py`
- [Market Analyst](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/infrastructure/llm_engine.py): `src/trading_agency/infrastructure/llm_engine.py`
- [LLM Factory](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/infrastructure/llm_factory.py): `src/trading_agency/infrastructure/llm_factory.py`

### Domain and Storage

- [Report Files](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/utils/utils.py): `src/trading_agency/utils/utils.py`
- [Trading Models](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/domain/models.py): `src/trading_agency/domain/models.py`
- [Market Repository](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/infrastructure/repository.py): `src/trading_agency/infrastructure/repository.py`
- [Result Types](https://github.com/itaygenkin/tradingagency/blob/main/src/trading_agency/domain/result.py): `src/trading_agency/domain/result.py`

### Other components

- **Operator**
- **Gemini LLM**
- **Market Data**
- **News Search**
- **PostgreSQL**
- **Redis Broker**

## Connections

- Operator → Day Pipeline: starts (evidence: `README.md`)
- Operator → Night Audit: starts (evidence: `README.md`)
- Day Pipeline → Market Provider: gets market data (evidence: `src/trading_agency/application/day_analysis.py`)
- Day Pipeline → Market Analyst: requests analysis (evidence: `src/trading_agency/application/day_analysis.py`)
- Day Pipeline → Report Files: saves report (evidence: `src/trading_agency/application/day_analysis.py`)
- Day Pipeline → Market Repository: stores predictions (evidence: `src/trading_agency/application/day_analysis.py`)
- Market Provider → Market Data: fetches prices (evidence: `README.md`)
- Market Provider → News Search: searches news (evidence: `src/trading_agency/infrastructure/market_provider.py`)
- Market Analyst → LLM Factory: gets model (evidence: `src/trading_agency/infrastructure/llm_engine.py`)
- LLM Factory → Gemini LLM: provides model (evidence: `README.md`)
- Market Analyst → Gemini LLM: invokes model (evidence: `src/trading_agency/infrastructure/llm_engine.py`)
- Day Pipeline → Trading Models: uses snapshots (evidence: `src/trading_agency/application/day_analysis.py`)
- Market Repository → PostgreSQL: reads and writes (evidence: `src/trading_agency/infrastructure/repository.py`)
- Night Audit → Market Repository: loads predictions (evidence: `src/trading_agency/application/night_audit.py`)
- Night Audit → Market Provider: gets performance (evidence: `src/trading_agency/application/night_audit.py`)
- Night Audit → Audit Tasks: dispatches audits (evidence: `src/trading_agency/application/night_audit.py`)
- Audit Tasks → Market Provider: gets performance (evidence: `src/trading_agency/application/celery_tasks.py`)
- Audit Tasks → Performance Validator: evaluates prediction (evidence: `src/trading_agency/application/celery_tasks.py`)
- Audit Tasks → Market Repository: updates results (evidence: `src/trading_agency/application/celery_tasks.py`)
- Performance Validator → Market Analyst: invokes LLM (evidence: `src/trading_agency/application/audit_service.py`)
- Performance Validator → Result Types: returns evaluation (evidence: `src/trading_agency/application/audit_service.py`)
- Audit Tasks → Celery App: registers task (evidence: `src/trading_agency/application/celery_tasks.py`)
- Celery App → Redis Broker: uses broker (evidence: `README.md`)
