# fincept-corporation/finceptterminal architecture

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

- Interactive diagram: https://gitdiagram.com/fincept-corporation/finceptterminal
- Repository: https://github.com/fincept-corporation/finceptterminal

## Overview

Fincept Terminal is a native Qt financial-research desktop application with embedded Python analytics. The user-facing workflow spans research and market-data analysis, portfolio and trading work, and AI-assisted research; the README also identifies backtesting, equity research, financial workflows, and quant research as capabilities. The graph preserves those product branches, plus storage and cloud sync. Several links come from README statements or sampled imports; unsampled implementation details are not inferred.

Main entry points: [`fincept-qt/src/app/main.cpp`](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/app/main.cpp) (Fincept Terminal), [`fincept-qt/src/services/llm/LlmService.cpp`](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/services/llm/LlmService.cpp) (LLM service), [`fincept-qt/src/algo_engine/AlgoEngine.cpp`](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/algo_engine/AlgoEngine.cpp) (Algo execution), [`fincept-qt/src/datahub/DataHub.h`](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/datahub/DataHub.h) (Market data hub)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["Desktop product"]
  node_terminal["Fincept Terminal<br/>[main.cpp]"]
  node_python["Embedded Python"]
end

subgraph group_research["Research and analytics"]
  node_equity["Equity research"]
  node_analytics["Financial analytics"]
  node_economics["Economic analysis"]
  node_portfolio["Portfolio management"]
  node_fixedincome["Fixed income"]
  node_corporate["Corporate finance"]
end

subgraph group_trading["Trading and quant"]
  node_backtesting["Backtesting"]
  node_algo["Algo execution<br/>[AlgoEngine.cpp]"]
  node_broker["Broker integration<br/>[BrokerInterface.h]"]
  node_arena["Alpha Arena<br/>[ArenaEngine.cpp]"]
end

subgraph group_intelligence["AI and workflows"]
  node_agents["Research agents<br/>[main.py]"]
  node_llm["LLM service<br/>[LlmService.cpp]"]
  node_mcp["MCP tools<br/>[McpManager.cpp]"]
  node_workflow["Financial workflows"]
end

subgraph group_platform["Data and platform"]
  node_datahub["Market data hub<br/>[DataHub.h]"]
  node_auth["Authentication<br/>[AuthManager.h]"]
  node_storage["Storage manager<br/>[StorageManager.cpp]"]
  node_database[("SQLite database<br/>[Database.h]")]
  node_secure[("Secure storage<br/>[SecureStorage.cpp]")]
  node_cloudsync["Cloud sync"]
end

node_user(("Research user"))

node_user -->|"uses"| node_terminal
node_terminal -->|"embeds analytics"| node_python
node_terminal -->|"offers research"| node_equity
node_terminal -->|"offers management"| node_portfolio
node_terminal -->|"offers backtests"| node_backtesting
node_terminal -->|"offers execution"| node_algo
node_terminal -->|"offers AI research"| node_agents
node_terminal -->|"offers workflows"| node_workflow
node_terminal -->|"uses data core"| node_datahub
node_llm -->|"reads data"| node_datahub
node_llm -->|"executes tools"| node_mcp
node_llm -->|"uses session"| node_auth
node_llm -->|"loads configuration"| node_storage
node_algo -->|"uses market data"| node_datahub
node_algo -->|"persists deployments"| node_database
node_arena -->|"loads credentials"| node_secure
node_storage -->|"uses database"| node_database
node_cloudsync -->|"checks session"| node_auth
node_cloudsync -->|"syncs local data"| node_database

click node_terminal "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/app/main.cpp"
click node_equity "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/services/equity/EquityResearchService.cpp"
click node_analytics "https://github.com/fincept-corporation/finceptterminal/tree/main/fincept-qt/scripts/Analytics"
click node_economics "https://github.com/fincept-corporation/finceptterminal/tree/main/fincept-qt/scripts/Analytics/economics"
click node_portfolio "https://github.com/fincept-corporation/finceptterminal/tree/main/fincept-qt/scripts/Analytics/portfolioManagement"
click node_fixedincome "https://github.com/fincept-corporation/finceptterminal/tree/main/fincept-qt/scripts/Analytics/fixedIncome"
click node_corporate "https://github.com/fincept-corporation/finceptterminal/tree/main/fincept-qt/scripts/Analytics/corporateFinance"
click node_backtesting "https://github.com/fincept-corporation/finceptterminal/tree/main/fincept-qt/scripts/Analytics/backtesting"
click node_algo "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/algo_engine/AlgoEngine.cpp"
click node_broker "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/trading/BrokerInterface.h"
click node_arena "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/services/alpha_arena/ArenaEngine.cpp"
click node_agents "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/scripts/agents/finagent_core/main.py"
click node_llm "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/services/llm/LlmService.cpp"
click node_mcp "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/mcp/McpManager.cpp"
click node_workflow "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/services/workflow/ExpressionEngine.cpp"
click node_python "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/python/PythonSetupManager.cpp"
click node_datahub "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/datahub/DataHub.h"
click node_auth "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/auth/AuthManager.h"
click node_storage "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/storage/StorageManager.cpp"
click node_database "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/storage/sqlite/Database.h"
click node_secure "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/storage/secure/SecureStorage.cpp"
click node_cloudsync "https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/services/cloud/CloudSyncEngine.cpp"

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_terminal,node_python,node_user toneBlue
class node_equity,node_analytics,node_economics,node_portfolio,node_fixedincome,node_corporate toneAmber
class node_backtesting,node_algo,node_broker,node_arena toneMint
class node_agents,node_llm,node_mcp,node_workflow toneRose
class node_datahub,node_auth,node_storage,node_database,node_secure,node_cloudsync toneIndigo
```

## Components

### Desktop product

- [Fincept Terminal](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/app/main.cpp): `fincept-qt/src/app/main.cpp`
- [Embedded Python](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/python/PythonSetupManager.cpp): `fincept-qt/src/python/PythonSetupManager.cpp`

### Research and analytics

- [Equity research](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/services/equity/EquityResearchService.cpp): `fincept-qt/src/services/equity/EquityResearchService.cpp`
- [Financial analytics](https://github.com/fincept-corporation/finceptterminal/tree/main/fincept-qt/scripts/Analytics): `fincept-qt/scripts/Analytics`
- [Economic analysis](https://github.com/fincept-corporation/finceptterminal/tree/main/fincept-qt/scripts/Analytics/economics): `fincept-qt/scripts/Analytics/economics`
- [Portfolio management](https://github.com/fincept-corporation/finceptterminal/tree/main/fincept-qt/scripts/Analytics/portfolioManagement): `fincept-qt/scripts/Analytics/portfolioManagement`
- [Fixed income](https://github.com/fincept-corporation/finceptterminal/tree/main/fincept-qt/scripts/Analytics/fixedIncome): `fincept-qt/scripts/Analytics/fixedIncome`
- [Corporate finance](https://github.com/fincept-corporation/finceptterminal/tree/main/fincept-qt/scripts/Analytics/corporateFinance): `fincept-qt/scripts/Analytics/corporateFinance`

### Trading and quant

- [Backtesting](https://github.com/fincept-corporation/finceptterminal/tree/main/fincept-qt/scripts/Analytics/backtesting): `fincept-qt/scripts/Analytics/backtesting`
- [Algo execution](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/algo_engine/AlgoEngine.cpp): `fincept-qt/src/algo_engine/AlgoEngine.cpp`
- [Broker integration](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/trading/BrokerInterface.h): `fincept-qt/src/trading/BrokerInterface.h`
- [Alpha Arena](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/services/alpha_arena/ArenaEngine.cpp): `fincept-qt/src/services/alpha_arena/ArenaEngine.cpp`

### AI and workflows

- [Research agents](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/scripts/agents/finagent_core/main.py): `fincept-qt/scripts/agents/finagent_core/main.py`
- [LLM service](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/services/llm/LlmService.cpp): `fincept-qt/src/services/llm/LlmService.cpp`
- [MCP tools](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/mcp/McpManager.cpp): `fincept-qt/src/mcp/McpManager.cpp`
- [Financial workflows](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/services/workflow/ExpressionEngine.cpp): `fincept-qt/src/services/workflow/ExpressionEngine.cpp`

### Data and platform

- [Market data hub](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/datahub/DataHub.h): `fincept-qt/src/datahub/DataHub.h`
- [Authentication](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/auth/AuthManager.h): `fincept-qt/src/auth/AuthManager.h`
- [Storage manager](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/storage/StorageManager.cpp): `fincept-qt/src/storage/StorageManager.cpp`
- [SQLite database](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/storage/sqlite/Database.h): `fincept-qt/src/storage/sqlite/Database.h`
- [Secure storage](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/storage/secure/SecureStorage.cpp): `fincept-qt/src/storage/secure/SecureStorage.cpp`
- [Cloud sync](https://github.com/fincept-corporation/finceptterminal/blob/main/fincept-qt/src/services/cloud/CloudSyncEngine.cpp): `fincept-qt/src/services/cloud/CloudSyncEngine.cpp`

### Other components

- **Research user**

## Connections

- Research user → Fincept Terminal: uses (evidence: `README.md`)
- Fincept Terminal → Embedded Python: embeds analytics (evidence: `README.md`)
- Fincept Terminal → Equity research: offers research (evidence: `README.md`)
- Fincept Terminal → Portfolio management: offers management (evidence: `README.md`)
- Fincept Terminal → Backtesting: offers backtests (evidence: `README.md`)
- Fincept Terminal → Algo execution: offers execution (evidence: `README.md`)
- Fincept Terminal → Research agents: offers AI research (evidence: `README.md`)
- Fincept Terminal → Financial workflows: offers workflows (evidence: `README.md`)
- Fincept Terminal → Market data hub: uses data core (evidence: `README.md`)
- LLM service → Market data hub: reads data (evidence: `fincept-qt/src/services/llm/LlmService.cpp`)
- LLM service → MCP tools: executes tools (evidence: `fincept-qt/src/services/llm/LlmService.cpp`)
- LLM service → Authentication: uses session (evidence: `fincept-qt/src/services/llm/LlmService.cpp`)
- LLM service → Storage manager: loads configuration (evidence: `fincept-qt/src/services/llm/LlmService.cpp`)
- Algo execution → Market data hub: uses market data (evidence: `fincept-qt/src/algo_engine/AlgoEngine.cpp`)
- Algo execution → SQLite database: persists deployments (evidence: `fincept-qt/src/algo_engine/AlgoEngine.cpp`)
- Alpha Arena → Secure storage: loads credentials (evidence: `fincept-qt/src/services/alpha_arena/ArenaEngine.cpp`)
- Storage manager → SQLite database: uses database (evidence: `fincept-qt/src/storage/StorageManager.cpp`)
- Cloud sync → Authentication: checks session (evidence: `fincept-qt/src/services/cloud/CloudSyncEngine.cpp`)
- Cloud sync → SQLite database: syncs local data (evidence: `fincept-qt/src/services/cloud/CloudSyncEngine.cpp`)
