repowiseai4finance-foundation/finrobot

Architecture of ai4finance-foundation/finrobot

ai4finance-foundation/finrobot is 928 source files holding 9,982 symbols across 4 modules, written mainly in Python, TypeScript, JavaScript. The largest module is finrobot_desktop, with 739 files, and 8 files are entry points into the dependency graph.

How finrobot fits together

FinRobot is made of three projects that share one financial domain layer, each in its own directory. finrobot_desktop/ is the V2 production system, a native desktop research app built on PydanticAI, FastAPI and React/Tauri, where a Lead Agent passes work to data, analysis, modeling, synthesis and report agents. Bull, bear and judge debate agents test the investment thesis, and the result is a traceable research report. Valuation calculations such as DCF, DDM, LBO and WACC run as deterministic operators, so the LLM narrates numbers that code has already computed. finrobot_equity/ is the V1 self-hosted web app, with a FastAPI interface that turns a ticker into a shareable HTML or PDF report. finrobot_autogen/ holds the V0 original AutoGen library, and the pip-installed finrobot package is built from it under the same import name.

Largest modules

  • finrobot_desktop: 739 files and 153,325 lines of code
  • finrobot_equity: 47 files and 13,321 lines of code
  • finrobot_autogen: 46 files and 4,719 lines of code
  • root: 2 files and 62 lines of code

Languages

By file count: Python 562 files, TypeScript 255 files, JavaScript 6 files, Shell 6 files, Rust 4 files, Dockerfile 1 file.

Documentation

Repowise documents finrobot in 1,202 pages generated from the source, 49 of them written explanations of the repository and its modules. Module guides include:

  • finrobot_autogen/finrobot: Agent Workflow
  • finrobot_desktop/desktop/src/config: Application Shell and Config
  • finrobot_desktop/finrobot/artifact: Artifact Builders and Persistence

More on finrobot: summary and FAQ, codebase overview, code health.

Related guide: Best dependency graph tools for monorepos