hsliuping/TradingAgents-CN

TradingAgents‑CN Community Edition – 개요

TradingAgents‑CN은 오픈 소스와 독점적 요소가 결합된 플랫폼으로, 애널리스트, 리서처, 어시스턴트 역할을 하는 여러 AI 에이전트 (LLMs)를 활용하여 중국 A주를 탐색할 수 있습니다. 시스템은 FastAPI 백엔드 (Python 3.11)와 Vue 3 프론트엔드로 구축되었으며, MongoDB와 Redis를 통해 데이터를 유지합니다.

핵심 개념

전문 에이전트 그룹(매크로 애널리스트, 섹터 애널리스트, 기본적 분석가, 뉴스 애널리스트, 낙관적/합리적 리서처 등)이 다중 턴 대화를 통해 주식이나 시장 테마에 대해 토론합니다.
토론 결과는 계층화된 관점으로 제시되어 사용자가 연구 과제를 다각도로 파악하도록 돕습니다.
사용자는 자연어 쿼리를 사용하여 즉석 연구를 수행하거나, 종목을 스크리닝하거나, 설명에 맞는 후보 종목을 제안하는 '종목 선택 어시스턴트'를 이용할 수 있습니다.
플랫폼에는 모의 투자 샌드박스와 무료 과정 및 가이드를 갖춘 학습 허브가 포함되어 있습니다.

주요 기능 (README 참조)

기능	내용
개별 종목 연구	5단계 깊이의 다각적 관점을 가진 멀티 에이전트 토론.
일반 연구	자연어로 시장 전체에 대한 질문을 하면 에이전트들이 협력하여 답변.
종목 스크리닝	6,000개 이상의 A주 종목을 대상으로 하는 자연어 + 조건 필터.
종목 선택 어시스턴트	투자 테마를 설명하면 시스템이 일치하는 종목을 제안.
지능형 어시스턴트	웹 검색, 도구 호출, 세션을 넘나드는 'AI 메모리' 통합.
AI 메모리	사실과 과거 분석을 저장하는 프로젝트 수준의 지식 베이스.
스킬 센터	사용자 정의 데이터 수집 '스킬'(새로운 데이터 소스 어댑터 등) 생성.
러닝 센터	무료 구조화 과정(현재 5개 레슨) 및 8개의 학습 가이드.
모의 투자 및 리플레이	거래 시뮬레이션 및 사후 검토.

아키텍처 및 기술 스택

백엔드: FastAPI (app/main.py)가 REST 엔드포인트를 제공하며 Python 3.11에서 실행.
프론트엔드: Vue 3 + TypeScript UI (frontend/)。
데이터 유지: MongoDB (사용자 데이터, 연구 결과, 에이전트 설정 저장) 및 Redis (캐싱, 세션 상태).
LLM 통합: OpenAI, DeepSeek, Alibaba‑Tongyi 등을 지원하며 API 키는 .env 파일에서 설정.
데이터 소스: 중국 시장 공개 API(Tushare, AKShare, BaoStock) 사용 (가격/재무 데이터용. 사용자가 직접 토큰을 획득해야 함).

라이선스

하이브리드 모델: 핵심 엔진 (tradingagents/, CLI, 문서, 테스트)은 Apache‑2.0으로 완전히 재사용 가능합니다. 애플리케이션 계층 (app/, frontend/, core/)은 소스가 공개되어 있으나 비상업적 용도입니다. 상업적 이용에는 별도의 라이선스가 필요합니다.

대상 사용자

학생 및 취미 사용자: 금융 분야의 멀티 에이전트 AI 워크플로우 구축을 실습하고 싶은 분.
연구자: LLM 기반 에이전트가 어떻게 협력하여 정량적/정성적 주식 분석을 수행할 수 있는지 탐구하고 싶은 분.
개발자: 에이전트 프레임워크 확장, 새로운 데이터 어댑터 추가, 사용자 정의 에이전트 구축에 관심 있는 분.

시작하기 (빠른 요약)

MongoDB와 Redis를 설치(또는 제공된 Docker 명령어 실행).
리포지토리를 클론하고 Python 가상 환경을 설정한 뒤 requirements.txt 설치.
.env.example을 .env로 복사하고 DB 자격 증명, JWT 시크릿, LLM API 키 입력.
uvicorn app.main:app (백엔드)을 실행하고 frontend 내에서 npm run dev (UI) 실행.
자동 생성된 관리자 계정(admin / .env의 비밀번호)으로 로그인.
시스템 설정에서 LLM 키를 설정하고 연구 도구 탐색 시작.

커뮤니티 및 기여

프로젝트는 기여자(데이터 소스 어댑터, Vue UI 작업, 프롬프트 엔지니어링, 문서)를 적극적으로 모집합니다. 기여는 PR 품질에 따라 평가되며 기여자 동의서(CLA)가 필요합니다.

결론: TradingAgents‑CN은 중국 주식에 특화된 본격적인 멀티 에이전트 AI 리서치 어시스턴트로, LLM을 금융 분석에 활용하는 구체적인 사례를 제시하며 학습 플랫폼과 모의 투자 샌드박스를 제공합니다.