Vibe-Trading — AI 기반 멀티에이전트 트레이딩 워크스페이스
자연어 → 실행 가능한 트레이딩 전략. 29개 전문가 에이전트 팀, 7개 백테스트 엔진, 5개 데이터 소스.
핵심 컨셉
- Natural Language → Strategy — 아이디어를 설명하면 에이전트가 코드를 작성, 테스트, 내보냄
- 5 데이터 소스, 제로 설정 — A주, HK/US, 암호화폐, 선물 & 외환 자동 폴백 (AKShare, Tushare, CCXT)
- 29 전문가 팀 — 투자, 트레이딩 & 리스크용 사전 빌드된 멀티에이전트 서임 워크플로우
- 크로스 세션 메모리 — 선호도 및 인사이트 기억, 재사용 가능한 스킬 생성/진화
- 7 백테스트 엔진 — 크로스마켓 복합 테스트 + 통계 검증 (Monte Carlo, Bootstrap CI, Walk-Forward)
- 멀티 플랫폼 내보내기 — TradingView (Pine Script v6), TDX (通达信/同花顺), MetaTrader 5 (MQL5)
- DeepResearch for Trading — 71개 전문가 스킬, 5단계 컨텍스트 압축
최근 업데이트 (v0.1.5 — 2026-04-19)
- PyPI & ClawHub 배포
- 5개 새 MCP 도구:
analyze_trade_journal+ 4개 shadow-account 도구 pattern_recognition→pattern레지스트리 수정- Docker 의존성 정합, SKILL 매니페스트 동기화 (22 MCP 도구 / 71 스킬)
Shadow Account (v0.1.4)
- 브로커 저널에서 전략 규칙 추출
- 시장 전체에서 shadow 백테스트
- 8섹션 HTML/PDF 리포트 (규정 위반, 조기 종료, 놓친 신호, 반사실 거래)
Trade Journal Analyzer (v0.1.4)
- 브로커 내보내기 업로드 (同花顺/东财/富途/generic CSV)
- 자동 트레이딩 프로필 (보유 기간, 승률, PnL 비율, 드로우다운)
- 4개 편향 진단 (처분 효과, 과거래, 모멘텀 추종, 앵커링)
Agent Harness (v0.1.4)
- 지속적 크로스 세션 메모리
- FTS5 세션 검색
- 자기진화 스킬 (전체 CRUD)
- 5단계 컨텍스트 압축
- 읽기/쓰기 도구 배치
설치
PyPI
pip install vibe-trading-aiDocker (제로 설정)
git clone https://github.com/HKUDS/Vibe-Trading.git
cd Vibe-Trading
cp agent/.env.example agent/.env
# LLM provider 설정
docker compose up --buildhttp://localhost:8899에서 접속
로컬 설치
git clone https://github.com/HKUDS/Vibe-Trading.git
cd Vibe-Trading
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"프로젝트 구조
Vibe-Trading/
├── agent/ # Backend (Python)
│ ├── cli.py # CLI entrypoint — TUI + 서브커맨드
│ ├── src/skills/ # 71개 금융 스킬 정의 (SKILL.md)
│ ├── src/tools/ # 21+ 에이전트 도구
│ ├── src/agent/ # ReAct 에이전트 핵심
│ ├── src/providers/ # LLM provider 추상화
│ ├── backtest/ # 백테스트 엔진, 로더, 옵티마이저
│ └── config/swarm/ # 29개 서임 프리셋 YAML
├── frontend/ # React 19 + Vite web UI
└── agent/.env.example # LLM provider 설정
데이터 소스 (5개, 자동 폴백)
| 소스 | 커버리지 | 비용 |
|---|---|---|
| AKShare | A주, US, HK, 선물, 외환 | 무료 |
| Tushare | A주 상세 데이터 | 토큰 필요 |
| CCXT | 암호화폐 거래소 | 무료 |
| 기타 | 폴백 소스 | 상이 |
기술 스택
| 레이어 | 기술 |
|---|---|
| Backend | Python |
| Agent | ReAct agent (크로스 세션 메모리) |
| Swarm | DAG 기반 멀티에이전트 오케스트레이션 |
| Frontend | React 19 + Vite |
| Backtest | 커스텀 엔진 (7 시장 + 복합) |
| Data | AKShare, Tushare, CCXT + 자동 폴백 |
| LLM | 13개 프로바이더 (GPT, Claude, Qwen, Z.ai, MiniMax 등) |
서임 프리셋 (29개 팀)
- 투자 연구, 리스크 관리, 포트폴리오 최적화
- 기술 분석, 정량 분석
- 시장 감정, 뉴스 분석
- 전략 백테스트, 성과 귀속
- 기타 20+ 전문가 프리셋
vibe-trading --swarm-presets로 전체 탐색
개발
git clone https://github.com/HKUDS/Vibe-Trading.git
cd Vibe-Trading
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
cp agent/.env.example agent/.env테스트
pytest --ignore=agent/tests/e2e_backtest --tb=short -q개발 서버
# 터미널 1: API 서버
vibe-trading serve --port 8899
# 터미널 2: 프론트엔드
cd frontend && npm install && npm run dev기여하기
- 새 스킬:
agent/src/skills/에 단일SKILL.md파일 - 카테고리:
data-source,strategy,analysis,risk,export - Python: Google 스타일 docstrings, 타입 힌트 권장
- 파일 크기: < 400줄, 최대 800줄
생태계
HKUDS 에이전트 생태계 구성원:
- ClawTeam — 에이전트 서임 인텔리전스
- NanoBot — 초경량 개인 AI 어시스턴트
- 2026-05-01-trading-growth-workbenches — 분석/전략/실행/성장 레이어를 묶는 상위 비교 노트
- CLI-Anything — 모든 소프트웨어 에이전트 네이티브화