AI 에이전트 팀이 트레이딩 회사처럼 역할을 나눠 한 종목을 분석하는 연구용 프레임워크(Tauric Research · Apache-2.0)
TradingAgents
티커 하나를 넣으면 분석팀 넷(재무 · 감성 · 뉴스 · 기술)이 동시에 자료를 모아 보고서를 쓰고, 강세 · 약세 연구원이 토론하며, 트레이더가 거래 제안을 만들고, 리스크팀이 따져 본 뒤 포트폴리오 매니저가 승인하거나 거절합니다. 승인된 제안은 모의 거래소로 갑니다. Yahoo Finance 가 다루는 시장(미국 · 홍콩 · 도쿄 · 런던 · 코인 등)의 티커를 받고, 보고서는 한 페이지 HTML 로도 저장됩니다. LangGraph 로 만들었습니다.
- 가격
- 무료 · 오픈소스
- 라이선스
- Apache-2.0
- GitHub 별
- 119,345 2026-11-01
공식 설치
git clone https://github.com/TauricResearch/TradingAgents.git
공식 저장소를 받고 cd TradingAgents 로 들어갑니다.
uv venv --python 3.13
Python 3.11 이상 가상 환경을 만듭니다(공식 예시). 맥 · 리눅스는 source .venv/bin/activate, 윈도우는 .venv\Scripts\activate 로 켭니다. conda 를 쓰면 conda create -n tradingagents python=3.13 → conda activate tradingagents.
pip install .
패키지와 의존성을 설치합니다(uv 는 uv pip install .).
tradingagents
화면에서 티커 · 분석 날짜 · 모델 공급자 · 분석 깊이를 고르고 실행합니다. 질문 없이 돌리려면 tradingagents --ticker NVDA --date 2026-09-23 --analysts market,news,fundamentals --save --no-show 처럼 플래그를 줍니다(공식 예시).
막히는 자리
- pip install 에서 버전 오류가 나면 Python 이 3.11 이상인지 먼저 봅니다(pyproject 기준).
- API 키로 돌리면 .env.example 을 .env 로 복사해 쓸 회사 키 한 줄만 직접 채웁니다. 키를 채팅이나 이 페이지에 붙여 넣지 마세요.
- 키 없이 돌리려면 Ollama 를 깔고 ollama pull <모델 이름> 으로 모델을 받은 뒤 CLI 에서 공급자를 Ollama 로 고릅니다. 기본 주소는 http://localhost:11434/v1 이고, 목록에 없는 모델은 Custom model ID 로 넣습니다.
- ChatGPT Plus · Pro 구독으로 돌리려면 공급자 메뉴에서 Subscription 을 고르고 tradingagents login chatgpt 로 한 번 로그인합니다(브라우저에서 직접).
- 같은 종목 · 같은 날짜도 다시 돌리면 결과가 다를 수 있습니다. 모델 응답과 뉴스 · 커뮤니티 자료가 매번 달라지기 때문이며 오류가 아닙니다(공식 Reproducibility 절).