AI4Finance-Foundation/FinRobot

FinRobot: An Open-Source AI Agent Platform for Financial Applications using Large Language Models

FinRobot – 금융 분야를 위한 오픈소스 AI 에이전트 플랫폼

무엇인가요 – FinRobot은 대규모 언어 모델(LLM)을 사용해 에이전트 기반 금융 분석 애플리케이션을 구축할 수 있도록 해주는 세 가지 관련 코드베이스의 집합입니다. 이 프로젝트의 철학은 다음과 같습니다:

모델이 추론한다 – LLM은 서사, 사고의 연쇄, 어떤 도구를 호출할지 결정합니다.
소프트웨어가 계산한다 – DCF, DDM, LBO, 몬테카를로 등 모든 수치적 금융 계산은 순수한 Python 함수로 수행되어 결정론적 결과와 완전한 출처를 보장합니다.
에이전트가 조율한다 – 주도적인 "조율 에이전트"는 전문 에이전트(데이터 수집, 분석, 모델링, 통합, 보고서 작성)와 논쟁 에이전트( bull, bear, judge)의 파이프라인을 조율하여 추적 가능한 연구 결과를 생성합니다.
시스템이 검증한다 – 감사 에이전트는 수치를 검사하고, 출처를 기록하며, 신뢰도 점수를 공개합니다.

세 가지 버전, 하나의 금융 도메인 계층

디렉터리	버전	목적
`finrobot_desktop/`	V2 – 프로덕션 수준 데스크톱 앱 (PydanticAI + FastAPI + React/Tauri)	기능이 풍부한 주식 연구 워크스테이션; 13장짜리 보고서, 실시간 시장 데이터, 결정론적 평가표 생성
`finrobot_equity/`	V1 – 자체 호스팅 웹 앱 (OpenAI Agents SDK)	티커를 HTML/PDF 연구 보고서로 변환하는 빠른 시작 서비스
`finrobot_autogen/`	V0 – 교육용 AutoGen 라이브러리 (pip 설치 가능한 `finrobot`)	참조 구현 및 튜토리얼; 프로덕션용이 아님

핵심 설계 아이디어

결정론적 계산 + LLM 서사화 – 수치는 코드에서 나옴; LLM은 그 주변의 이야기만 작성. 모든 출력에는 출처 태그가 붙음 (어떤 연산자가 수치를 생성했는지, 어떤 데이터 소스가 사용되었는지).
모듈식 에이전트 스택 – 동일한 금융 도구는 어떤 새로운 에이전트 프레임워크와도 결합 가능 (AutoGen → OpenAI Agents SDK → PydanticAI → 미래의 DeepSeek-Harness).
풍부한 금융 도구 – 내장된 데이터 제공자 (Finnhub, FMP, yfinance, SEC EDGAR, 뉴스 아그리게이터, 환율), 32개의 순수 Python 평가 연산자, 56개의 "플레이북" (주식 연구, 투자은행, 프라이빗에쿼티, 자산관리 워크플로우 포함).

시작하기 (요약)

데스크톱 (V2) – macOS Apple-Silicon용 .dmg를 다운로드하거나 로컬에서 소스를 실행:
```
cd finrobot_desktop
uv sync               # 백엔드 종속성 설치
(cd desktop && npm install)  # 프론트엔드 한 번 설치
./dev.sh              # FastAPI 백엔드 + Vite 개발 서버 실행
```
UI는 http://localhost:5173 에서 접근 가능하며, 네이티브 Tauri 앱과 동일한 동작을 합니다.
웹 앱 (V1) – config.ini.example를 복사하고 API 키를 삽입한 후, ./finrobot_equity/deploy.sh start를 실행하여 http://127.0.0.1:8001에서 서비스 제공.
교육용 라이브러리 (V0) – pip install finrobot (또는 리포지토리 루트에서 pip install -e .)로 설치. finrobot_autogen/tutorials_*의 Jupyter 노트북을 따라가면 에이전트가 연간 보고서, 시장 전망, 거래 전략 등을 생성하는 모습을 확인할 수 있습니다.

예제 명령어 (데스크톱 CLI)

finrobot research AAPL          # 13장짜리 주식 연구 보고서
finrobot dcf MSFT               # DCF 평가 (적절한 경우 DDM으로 자동 전환)
finrobot comps NVDA --peers AMD,INTC
finrobot ic-memo TSLA           # 투자위원회 메모
finrobot ask AAPL "관세에 대한 매출원가율 노출은 어느 정도인가요?"

모든 명령어는 다음을 포함하는 구조화된 아티팩트를 생성합니다:

데이터 테이블 (코드로 계산, 그 점을 명시)
서사 섹션 (LLM 생성, 테이블 참조)
신뢰도 점수 및 감사 노트.

생태계 및 로드맵

FinRobot Pro – 동일한 기능을 클라우드 서비스로 제공하는 호스팅 SaaS 버전 (https://finrobot.ai/).
미래의 V3 – DeepSeek-Harness 프레임워크로 개발 중이며, 더 자율적인 에이전트를 목표로 하되 검증 제약을 유지합니다.
연구 기반 – 리포지토리는 화이트페이퍼(arXiv 2405.14767)를 인용하며, 최근의 AI 에이전트 문헌(예: 스탠포드의 Generative Agents)과 일치합니다.

누구에게 적합한가요?

퀀트 분석가 / 주식 연구자 – 수치가 감사된 코드로 생성됨을 보장하는 AI 보조 워크플로우를 원하는 사람.
FinTech 개발자 – 다양한 LLM 백엔드에 쉽게 교체 가능한 즉시 사용 가능한 다중 에이전트 스택을 찾는 사람.
학생 및 연구자 – LLM, 도구 호출, 결정론적 금융의 통합 방법을 배우고 싶은 사람.

결론: FinRobot은 대규모 언어 모델과 결정론적 금융 계산 엔진을 결합한 진정한 프로덕션 중심의 오픈소스 플랫폼이며, 데스크톱 앱, 웹 서비스, 교육용 라이브러리로 패키지화되어 있습니다. 금융 분야의 AI 에이전트 영역에 확고한 위치를 차지하고 있습니다.