Vibe-Trading: 당신의 개인 트레이딩 에이전트

한 번의 명령으로 에이전트를 종합 트레이딩 기능으로 강화

기능 · 데모 · 개요 · 시작하기 · CLI · API · MCP · 구조 · 로드맵 · 기여 · 기여자

--- ## 📰 뉴스 - **2026-05-04** 🖥️ **대화형 CLI UX + CI 정리**: 대화형 모드에 provider/model, 세션 시간, 직전 실행 시간, 누적 도구 호출 통계를 보여주는 실시간 하단 상태 표시줄이 추가되었습니다. 또한 `prompt_toolkit`을 통해 위/아래 방향키 히스토리 탐색과 좌/우 방향키 커서 편집을 지원합니다([#69](https://github.com/HKUDS/Vibe-Trading/pull/69)). `prompt_toolkit` 또는 TTY를 사용할 수 없으면 기존 Rich prompt로 자동 폴백합니다. CI 경로 기대값도 강화된 파일 import 샌드박스와 크로스플랫폼 `/tmp` 해석에 맞춰 정리되어 main이 다시 green 상태가 되었습니다([`bb67dc7`](https://github.com/HKUDS/Vibe-Trading/commit/bb67dc7cfcc11553c57d8962bee56381dca43758)). - **2026-05-03** 🛡️ **보안 강화 패치**: 비로컬 배포의 기본 API 인증을 강화하고, 민감한 run/session/swarm 읽기 API를 보호하며, 업로드와 로컬 파일 읽기 경계를 제한하고, shell 가능 도구를 진입점별로 제어합니다. 생성된 전략은 import 전에 검증되며 Docker 이미지는 기본적으로 비root 사용자와 localhost 전용 포트 공개로 실행됩니다. CLI와 localhost Web UI 흐름은 낮은 마찰을 유지합니다. 원격 API/Web 배포에서는 `API_AUTH_KEY`를 설정하세요. - **2026-05-02** 🧭 **배당 분석 + 더 선명한 로드맵**: 인컴 주식, 배당 지속 가능성, 배당 성장, 주주환원 수익률, 배당락 메커니즘, 고배당 함정 점검을 다루는 `dividend-analysis` 스킬을 추가하고 bundled skill 회귀 테스트로 고정했습니다. 공개 로드맵은 Research Autopilot, Data Bridge, Options Lab, Portfolio Studio, Alpha Zoo, Research Delivery, Trust Layer, Community 공유에 집중하도록 정리했습니다.

이전 뉴스

- **2026-05-01** 🔥 **상관관계 히트맵 + OpenAI Codex OAuth + A주 pre-ST 필터**: 새 상관관계 대시보드/API가 롤링 수익률 상관관계를 계산하고, 포트폴리오 및 종목 분석용 ECharts 히트맵으로 렌더링합니다([#64](https://github.com/HKUDS/Vibe-Trading/pull/64)). OpenAI Codex provider는 이제 `vibe-trading provider login openai-codex`로 ChatGPT OAuth를 사용할 수 있으며, Settings 메타데이터와 어댑터 회귀 테스트도 추가되었습니다([#65](https://github.com/HKUDS/Vibe-Trading/pull/65)). A주 ST/*ST 리스크 스크리닝을 위한 `ashare-pre-st-filter` 스킬을 추가하고 강화했으며, Sina 제재 공시 관련성 필터링으로 증권 계좌 목록 언급이 E2 횟수를 부풀리지 않도록 했습니다([#63](https://github.com/HKUDS/Vibe-Trading/pull/63)). - **2026-04-30** ⚙️ **Web UI 설정 + validation CLI 강화**: LLM provider/model, Base URL, reasoning effort, 데이터 소스 자격 증명을 로컬에서 설정할 수 있는 Settings 페이지를 추가했습니다. settings API는 local/auth로 보호되며 provider 메타데이터도 데이터 기반 설정으로 분리되었습니다([#57](https://github.com/HKUDS/Vibe-Trading/pull/57)). 또한 `python -m backtest.validation `가 인자 없음, 빈 경로, 잘못된 경로, 존재하지 않는 경로, 디렉터리가 아닌 경로를 검증 시작 전에 명확한 메시지로 실패하도록 강화했습니다([#60](https://github.com/HKUDS/Vibe-Trading/pull/60)). - **2026-04-28** 🚀 **v0.1.6 릴리스**（`pip install -U vibe-trading-ai`）: `pip install` / `uv tool install` 설치 후 `vibe-trading --swarm-presets`가 비어 있는 문제 수정([#55](https://github.com/HKUDS/Vibe-Trading/issues/55)) — 프리셋 YAML을 `src.swarm` 패키지 내부에 번들링, 6개 회귀 테스트로 고정. 또한 AKShare 로더가 ETF(`510300.SH`)와 외환(`USDCNH`)을 올바른 엔드포인트로 라우팅하고 레지스트리 폴백 강화. v0.1.5 이후 업데이트 종합: 벤치마크 비교 패널, `/upload` 스트리밍 + 크기 제한, Futu 로더(HK + A주), vnpy 내보내기 스킬, 보안 강화, 프론트엔드 지연 로딩(688KB → 262KB). - **2026-04-27** 📊 **벤치마크 비교 패널 + 업로드 안전성**: 백테스트 출력에 벤치마크 비교 패널(티커 / 벤치마크 수익률 / 초과 수익률 / 정보 비율) 추가, yfinance로 SPY · CSI 300 등 자동 해석([#48](https://github.com/HKUDS/Vibe-Trading/issues/48)). 또한 `/upload` 엔드포인트를 1MB 청크 스트리밍으로 전환, `MAX_UPLOAD_SIZE` 초과 시 즉시 중단 + 부분 파일 정리. 50MB 상한이 악성/초대형 요청에도 실효화([#53](https://github.com/HKUDS/Vibe-Trading/pull/53)) — 4개 회귀 테스트로 고정. - **2026-04-22** 🛡️ **하드닝 + 신규 연동**: `safe_path`에 경로 컨테인먼트 강제 + 거래 명세서/섀도우 계정 도구 샌드박스화, `MANIFEST.in` 추가로 sdist에 `.env.example` / 테스트 / Docker 파일 포함, 프론트엔드 라우트 단위 지연 로딩으로 초기 번들 688KB → 262KB. 또한 Futu 홍콩/A주 데이터 로더([#47](https://github.com/HKUDS/Vibe-Trading/pull/47))와 vnpy CtaTemplate 내보내기 스킬([#46](https://github.com/HKUDS/Vibe-Trading/pull/46)) 추가. - **2026-04-21** 🛡️ **워크스페이스 + 문서**: 상대 `run_dir`을 활성 run 디렉토리로 정규화([#43](https://github.com/HKUDS/Vibe-Trading/pull/43)). README 사용 예제 추가([#45](https://github.com/HKUDS/Vibe-Trading/pull/45)). - **2026-04-20** 🔌 **추론 모델 + Swarm 수정**: `reasoning_content`을 모든 `ChatOpenAI` 직렬화 경로에서 보존 — Kimi / DeepSeek / Qwen thinking 엔드투엔드 작동([#39](https://github.com/HKUDS/Vibe-Trading/issues/39)). Swarm 스트리밍 + 깔끔한 Ctrl+C 종료([#42](https://github.com/HKUDS/Vibe-Trading/issues/42)). - **2026-04-19** 📦 **v0.1.5**: PyPI 및 ClawHub에 게시. `python-multipart` CVE 하한 버전 업데이트, 5개 신규 MCP 도구 연결(`analyze_trade_journal` + 4개 섀도우 계정 도구), `pattern_recognition` → `pattern` 레지스트리 이름 불일치 수정, Docker 의존성 동기화, SKILL 매니페스트 동기화(22개 MCP 도구 / 71개 스킬). - **2026-04-18** 👥 **섀도우 계정 Shadow Account**: 증권사 거래 명세서에서 자신의 전략 규칙을 추출 → 여러 시장에서 섀도우 백테스트 실행 → 8개 섹션 HTML/PDF 리포트가 어디에서 얼마를 놓쳤는지(규칙 위반, 조기 익절, 놓친 시그널, 역방향 거래) 정확히 보여줌. 신규 도구 4개, 신규 스킬 1개, 총 32개 도구. Trade Journal / Shadow Account 샘플 프롬프트가 Web UI 웰컴 화면에 추가. - **2026-04-17** 📊 **거래 명세서 분석기 + 유니버설 파일 리더**: 증권사 거래 명세서(同花顺/东财/富途/일반 CSV) 업로드 → 거래 프로필(보유 일수, 승률, 손익비, 최대 드로다운) + 4가지 행동 편향 진단(처분 효과, 과잉 거래, 추격 매수, 앵커링) 자동 생성. `read_document`는 이제 PDF, Word, Excel, PowerPoint, 이미지(OCR), 40+ 텍스트 형식을 하나의 호출로 통합 처리. - **2026-04-16** 🧠 **에이전트 하네스**: 크로스세션 영구 메모리, FTS5 세션 검색, 자가 진화 스킬(전체 CRUD), 5계층 컨텍스트 압축, 읽기/쓰기 도구 배치 처리. 27개 도구, 107개 신규 테스트. - **2026-04-15** 🤖 **Z.ai + MiniMax**: Z.ai 제공자 추가([#35](https://github.com/HKUDS/Vibe-Trading/pull/35)), MiniMax temperature 수정 + 모델 업데이트([#33](https://github.com/HKUDS/Vibe-Trading/pull/33)). 13개 제공자. - **2026-04-14** 🔧 **MCP 안정성**: 백테스트 도구의 stdio 전송에서 `Connection closed` 오류 수정([#32](https://github.com/HKUDS/Vibe-Trading/pull/32)). - **2026-04-13** 🌐 **크로스마켓 복합 백테스트**: 새 `CompositeEngine`으로 서로 다른 시장 종목(예: A주 + 암호화폐)을 공유 자금 풀로 동시 백테스트, 시장 규칙은 종목별 적용. Swarm 템플릿 변수 폴백 및 프론트엔드 타임아웃도 수정. - **2026-04-12** 🌍 **멀티 플랫폼 내보내기**: `/pine`으로 TradingView (Pine Script v6), TDX (통달신/동화순/동방재부), MetaTrader 5 (MQL5) 한 번에 내보내기. - **2026-04-11** 🛡️ **안정성 및 DX**: `vibe-trading init` .env 부트스트랩([#19](https://github.com/HKUDS/Vibe-Trading/pull/19)), 프리플라이트 체크, 데이터소스 폴백, 백테스트 엔진 강화. 다국어 README([#21](https://github.com/HKUDS/Vibe-Trading/pull/21)). - **2026-04-10** 📦 **v0.1.4**: Docker 수정([#8](https://github.com/HKUDS/Vibe-Trading/issues/8)), `web_search` MCP 도구, 12개 LLM 제공자, `akshare`/`ccxt` 의존성. PyPI와 ClawHub에 게시. - **2026-04-09** 📊 **Backtest Wave 2**: ChinaFutures, GlobalFutures, Forex, Options v2 엔진. 몬테카를로, Bootstrap CI, 워크포워드 검증. - **2026-04-08** 🔧 **다중 시장 백테스트**: 시장별 규칙, Pine Script v6 내보내기, 자동 폴백 5개 데이터 소스.

--- ## 💡 Vibe-Trading이란? Vibe-Trading은 AI 기반 멀티 에이전트 금융 워크스페이스로, 자연어 요청을 전 세계 시장의 실행 가능한 트레이딩 전략, 리서치 인사이트, 포트폴리오 분석으로 전환합니다. ### 핵심 역량: • **자연어 → 전략** — 아이디어를 설명하면 에이전트가 코드 작성, 테스트, 내보내기까지 실행
• **6개 데이터 소스, 무설정** — A주, HK/US, 크립토, 선물, FX 자동 폴백
• **29개 전문 팀** — 투자, 트레이딩, 리스크를 위한 멀티 에이전트 스웜 워크플로우
• **크로스세션 메모리** — 선호도와 인사이트를 기억하고 재사용 가능한 스킬을 자동 생성·진화
• **7개 백테스트 엔진** — 크로스마켓 복합 테스트 + 통계 검증 + 4개 옵티마이저
• **멀티 플랫폼 내보내기** — 클릭 한 번으로 TradingView, TDX(통달신/동화순), MetaTrader 5 --- ## ✨ 주요 기능

🔍 트레이딩용 DeepResearch

• 74개 전문 스킬 + 크로스세션 영구 메모리
• 자가 진화: 에이전트가 경험으로부터 워크플로우를 생성·개선
• 5계층 컨텍스트 압축 — 긴 대화에서도 정보 손실 없음
• 전 금융 도메인에 걸친 자연어 태스크 라우팅

🐝 스웜 인텔리전스

• 29개 즉시 사용 가능한 트레이딩 팀 프리셋
• DAG 기반 멀티 에이전트 오케스트레이션
• 실시간 스트리밍 대시보드(에이전트 상태 표시)
• FTS5 크로스세션 검색으로 모든 과거 대화 검색

📊 크로스마켓 백테스트

• A주, 홍콩/미국 주식, 크립토, 선물 및 FX
• 7개 시장 엔진 + 크로스마켓 복합 엔진(공유 자금 풀)
• 통계 검증: 몬테카를로, Bootstrap CI, 워크포워드
• 15+ 성과 지표 및 4개 옵티마이저

🧮 퀀트 분석 툴킷

• 팩터 IC/IR 분석 및 분위 백테스트
• 블랙-숄즈 가격 산출 및 풀 그릭스 계산
• 기술적 패턴 인식 및 감지
• MVO/리스크 패리티/BL 기반 포트폴리오 최적화

## 8개 카테고리에 걸친 74개 스킬 - 📊 8개 카테고리에 조직된 74개 금융 스킬 - 🌐 전통 시장부터 크립토·DeFi까지 완전 커버리지 - 🔬 데이터 소싱부터 정량 리서치까지 포괄적 기능 | 카테고리 | 스킬 | 예시 | |----------|------|------| | Data Source | 6 | `data-routing`, `tushare`, `yfinance`, `okx-market`, `akshare`, `ccxt` | | Strategy | 17 | `strategy-generate`, `cross-market-strategy`, `technical-basic`, `candlestick`, `ichimoku`, `elliott-wave`, `smc`, `multi-factor`, `ml-strategy` | | Analysis | 17 | `factor-research`, `macro-analysis`, `global-macro`, `valuation-model`, `earnings-forecast`, `credit-analysis`, `dividend-analysis` | | Asset Class | 9 | `options-strategy`, `options-advanced`, `convertible-bond`, `etf-analysis`, `asset-allocation`, `sector-rotation` | | Crypto | 7 | `perp-funding-basis`, `liquidation-heatmap`, `stablecoin-flow`, `defi-yield`, `onchain-analysis` | | Flow | 7 | `hk-connect-flow`, `us-etf-flow`, `edgar-sec-filings`, `financial-statement`, `adr-hshare` | | Tool | 10 | `backtest-diagnose`, `report-generate`, `pine-script`, `doc-reader`, `web-reader`, `vnpy-export` | | Risk Analysis | 1 | `ashare-pre-st-filter` | ## 29개 에이전트 스웜 팀 프리셋 - 🏢 29개 즉시 사용 가능한 에이전트 팀 - ⚡ 사전 구성된 금융 워크플로우 - 🎯 투자, 트레이딩 및 리스크 관리 프리셋 | 프리셋 | 워크플로우 | |--------|------------| | `investment_committee` | 불/베어 토론 → 리스크 리뷰 → PM 최종 결정 | | `global_equities_desk` | A주 + HK/US + 크립토 리서처 → 글로벌 전략가 | | `crypto_trading_desk` | 펀딩/베이시스 + 청산 + 플로우 → 리스크 매니저 | | `earnings_research_desk` | 펀더멘털 + 리비전 + 옵션 → 실적 전략가 | | `macro_rates_fx_desk` | 금리 + FX + 원자재 → 매크로 PM | | `quant_strategy_desk` | 스크리닝 + 팩터 리서치 → 백테스트 → 리스크 감사 | | `technical_analysis_panel` | 클래식 TA + 일목균형표 + 하모닉 + 엘리엇 + SMC → 컨센서스 | | `risk_committee` | 드로다운 + 테일 리스크 + 레짐 리뷰 → 승인 | | `global_allocation_committee` | A주 + 크립토 + HK/US → 크로스마켓 배분 | _{추가로 20+ 특화 프리셋 — 모든 항목은 vibe-trading --swarm-presets로 확인.} ### 🎬 데모

https://github.com/user-attachments/assets/4e4dcb80-7358-4b9a-92f0-1e29612e6e86	https://github.com/user-attachments/assets/3754a414-c3ee-464f-b1e8-78e1a74fbd30
_{☝️ 자연어 백테스트 & 멀티 에이전트 스웜 토론 — Web UI + CLI}

--- ## 🚀 빠른 시작 ### 한 줄 설치 (PyPI) ```bash pip install vibe-trading-ai ``` > **패키지 이름 vs 명령:** PyPI 패키지는 `vibe-trading-ai`입니다. 설치하면 세 가지 명령을 얻습니다: > > | Command | Purpose | > |---------|---------| > | `vibe-trading` | 인터랙티브 CLI / TUI | > | `vibe-trading serve` | FastAPI 웹 서버 실행 | > | `vibe-trading-mcp` | MCP 서버 시작(Claude Desktop, OpenClaw, Cursor 등) | ```bash vibe-trading init # 인터랙티브 .env 설정 vibe-trading # CLI 실행 vibe-trading serve --port 8899 # 웹 UI 실행 vibe-trading-mcp # MCP 서버 시작(stdio) ``` ### 또는 경로 선택 | Path | 최적 용도 | 소요 시간 | |------|-----------|-----------| | **A. Docker** | 즉시 체험, 로컬 설정 없음 | 2분 | | **B. Local install** | 개발, 전체 CLI 접근 | 5분 | | **C. MCP plugin** | 기존 에이전트에 플러그인 | 3분 | | **D. ClawHub** | 한 줄 설치, 클론 불필요 | 1분 | ### 사전 요구사항 - 지원 제공자의 **LLM API 키** — 또는 **Ollama** 로컬 실행(키 불필요) - 경로 B용 **Python 3.11+** - 경로 A용 **Docker** > **지원 LLM 제공자:** OpenRouter, OpenAI, DeepSeek, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, Xiaomi MIMO, Z.ai, Ollama(로컬). 설정은 `.env.example` 참고. > **팁:** 모든 시장은 자동 폴백 덕분에 API 키 없이도 작동합니다. yfinance(HK/US), OKX(크립토), AKShare(A주, 미국, HK, 선물, FX)는 모두 무료입니다. Tushare 토큰은 선택 사항 — AKShare가 A주 무료 폴백을 제공합니다. ### 경로 A: Docker (설정 불필요) ```bash git clone https://github.com/HKUDS/Vibe-Trading.git cd Vibe-Trading cp agent/.env.example agent/.env # agent/.env 수정 — 사용할 LLM 제공자를 주석 해제하고 API 키 설정 docker compose up --build ``` `http://localhost:8899`를 엽니다. 백엔드 + 프런트엔드가 하나의 컨테이너에 있습니다. Docker는 기본적으로 백엔드를 `127.0.0.1:8899`에만 게시하고, 비root 컨테이너 사용자로 앱을 실행합니다. API를 자신의 머신 밖으로 의도적으로 노출하는 경우 강한 `API_AUTH_KEY`를 설정하고 클라이언트에서 `Authorization: Bearer `를 보내세요. ### 경로 B: 로컬 설치 ```bash git clone https://github.com/HKUDS/Vibe-Trading.git cd Vibe-Trading python -m venv .venv # 활성화 source .venv/bin/activate # Linux / macOS # .venv\Scripts\Activate.ps1 # Windows PowerShell pip install -e . cp agent/.env.example agent/.env # 편집 — LLM 제공자 API 키 설정 vibe-trading # 인터랙티브 TUI 실행 ```

웹 UI 시작(선택 사항)

```bash # 터미널 1: API 서버 vibe-trading serve --port 8899 # 터미널 2: 프런트엔드 개발 서버 cd frontend && npm install && npm run dev ``` `http://localhost:5899`를 엽니다. 프런트엔드는 `localhost:8899`로 API를 프록시합니다. **프로덕션 모드(단일 서버):** ```bash cd frontend && npm run build && cd .. vibe-trading serve --port 8899 # FastAPI가 dist/를 정적 파일로 서빙 ```

### 경로 C: MCP 플러그인 아래 [MCP 플러그인](#-mcp-플러그인) 섹션을 참조하세요. ### 경로 D: ClawHub (한 줄) ```bash npx clawhub@latest install vibe-trading --force ``` 스킬과 MCP 설정이 에이전트의 스킬 디렉터리에 다운로드됩니다. 자세한 내용은 [ClawHub 설치](#-mcp-플러그인)를 참고하세요. --- ## 🧠 환경 변수 `agent/.env.example`을 `agent/.env`로 복사하고 원하는 제공자 블록의 주석을 해제하세요. 각 제공자에 3~4개의 변수가 필요합니다: | Variable | Required | Description | |----------|:--------:|-------------| | `LANGCHAIN_PROVIDER` | Yes | 제공자 이름(`openrouter`, `deepseek`, `groq`, `z.ai`, `ollama` 등) | | `_API_KEY` | Yes* | API 키(`OPENROUTER_API_KEY`, `DEEPSEEK_API_KEY` 등) | | `_BASE_URL` | Yes | API 엔드포인트 URL | | `LANGCHAIN_MODEL_NAME` | Yes | 모델 이름(예: `deepseek/deepseek-v3.2`) | | `TUSHARE_TOKEN` | No | A주 데이터용 Tushare Pro 토큰(AKShare 폴백) | | `TIMEOUT_SECONDS` | No | LLM 호출 타임아웃, 기본 120초 | | `API_AUTH_KEY` | 네트워크 배포 권장 | API가 비로컬 클라이언트에서 접근 가능한 경우 필요한 Bearer token | | `VIBE_TRADING_ENABLE_SHELL_TOOLS` | No | 원격 API / MCP-SSE 유형 배포에서 shell 가능 도구를 명시적으로 활성화 | | `VIBE_TRADING_ALLOWED_FILE_ROOTS` | No | 문서와 브로커 거래 명세서 import용 추가 루트(쉼표 구분) | | `VIBE_TRADING_ALLOWED_RUN_ROOTS` | No | 생성 코드 run 디렉터리용 추가 루트(쉼표 구분) | _{* Ollama는 API 키가 필요 없습니다.} **무료 데이터(키 불필요):** AKShare의 A주, yfinance의 HK/US 주식, OKX의 크립토, CCXT의 100+ 크립토 거래소. 시스템이 시장별로 최적 소스를 자동 선택합니다. ### 🎯 권장 모델 Vibe-Trading은 툴 호출에 크게 의존하는 에이전트입니다 — skill, 백테스트, 메모리, swarm이 모두 tool call을 통해 실행됩니다. 모델 선택이 에이전트가 **실제로 툴을 사용하는지**, 아니면 학습 데이터에서 답을 꾸며내는지를 결정합니다. | 등급 | 예시 | 용도 | |------|------|------| | **최상** | `anthropic/claude-opus-4.7`, `anthropic/claude-sonnet-4.6`, `openai/gpt-5.4`, `google/gemini-3.1-pro-preview` | 복잡한 swarm(3+ 에이전트), 긴 연구 세션, 논문급 분석 | | **가성비**(기본값) | `deepseek/deepseek-v3.2`, `x-ai/grok-4.20`, `z-ai/glm-5.1`, `moonshotai/kimi-k2.5`, `qwen/qwen3-max-thinking` | 일상 사용 — 안정적인 tool-calling, 비용 약 1/10 | | **에이전트용으로 피할 것** | `*-nano`, `*-flash-lite`, `*-coder-next`, 소형 / 증류 버전 | tool-calling 불안정 — skill 로드나 backtest 실행 대신 "기억으로 답변" | 기본 `agent/.env.example`은 `deepseek/deepseek-v3.2` 사용 — 가성비 등급에서 가장 저렴한 옵션. --- ## 🖥 CLI 참조 ```bash vibe-trading # 인터랙티브 TUI vibe-trading run -p "..." # 단일 실행 vibe-trading serve # API 서버 ```

TUI 내 슬래시 명령

| Command | Description | |---------|-------------| | `/help` | 모든 명령 표시 | | `/skills` | 74개 금융 스킬 목록 | | `/swarm` | 29개 스웜 팀 프리셋 목록 | | `/swarm run [vars_json]` | 라이브 스트리밍으로 스웜 팀 실행 | | `/swarm list` | 스웜 실행 이력 | | `/swarm show ` | 스웜 실행 상세 | | `/swarm cancel ` | 실행 중인 스웜 취소 | | `/list` | 최근 실행 | | `/show ` | 실행 상세 + 지표 | | `/code ` | 생성된 전략 코드 | | `/pine ` | 인디케이터 내보내기 (TradingView + TDX + MT5) | | `/trace ` | 전체 실행 리플레이 | | `/continue ` | 새 지시로 실행 계속 | | `/sessions` | 채팅 세션 목록 | | `/settings` | 런타임 설정 표시 | | `/clear` | 화면 지우기 | | `/quit` | 종료 |

단일 실행 & 플래그

```bash vibe-trading run -p "Backtest BTC-USDT MACD strategy, last 30 days" vibe-trading run -p "Analyze AAPL momentum" --json vibe-trading run -f strategy.txt echo "Backtest 000001.SZ RSI" | vibe-trading run ``` ```bash vibe-trading -p "your prompt" vibe-trading --skills vibe-trading --swarm-presets vibe-trading --swarm-run investment_committee '{"topic":"BTC outlook"}' vibe-trading --list vibe-trading --show vibe-trading --code vibe-trading --pine # 인디케이터 내보내기 (TradingView + TDX + MT5) vibe-trading --trace vibe-trading --continue "refine the strategy" vibe-trading --upload report.pdf ```

--- ## 🌐 API 서버 ```bash vibe-trading serve --port 8899 ``` | Method | Endpoint | Description | |--------|----------|-------------| | `GET` | `/runs` | 실행 목록 | | `GET` | `/runs/{run_id}` | 실행 상세 | | `GET` | `/runs/{run_id}/pine` | 멀티 플랫폼 인디케이터 내보내기 | | `POST` | `/sessions` | 세션 생성 | | `POST` | `/sessions/{id}/messages` | 메시지 전송 | | `GET` | `/sessions/{id}/events` | SSE 이벤트 스트림 | | `POST` | `/upload` | PDF/파일 업로드 | | `GET` | `/swarm/presets` | 스웜 프리셋 목록 | | `POST` | `/swarm/runs` | 스웜 실행 시작 | | `GET` | `/swarm/runs/{id}/events` | 스웜 SSE 스트림 | | `GET` | `/settings/llm` | Web UI LLM 설정 읽기 | | `PUT` | `/settings/llm` | 로컬 LLM 설정 업데이트 | | `GET` | `/settings/data-sources` | 로컬 데이터 소스 설정 읽기 | | `PUT` | `/settings/data-sources` | 로컬 데이터 소스 설정 업데이트 | 인터랙티브 문서: `http://localhost:8899/docs` ### 보안 기본값 localhost 개발에서는 `vibe-trading serve`가 브라우저 워크플로를 단순하게 유지합니다. 비로컬 클라이언트가 민감한 API에 접근하려면 `API_AUTH_KEY`가 필요합니다. JSON/업로드 요청에는 `Authorization: Bearer `를 사용하세요. 브라우저 EventSource 스트림은 Web UI Settings에 같은 키를 한 번 입력하면 처리됩니다. shell 가능 도구는 로컬 CLI와 신뢰된 localhost 워크플로에서 사용할 수 있지만, 원격 API 세션에는 기본적으로 노출되지 않습니다. 필요한 경우에만 `VIBE_TRADING_ENABLE_SHELL_TOOLS=1`을 명시적으로 설정하세요. 문서와 거래 명세서 리더는 기본적으로 업로드/import 루트로 제한됩니다. 파일은 `agent/uploads`, `agent/runs`, `./uploads`, `./data`, `~/.vibe-trading/uploads`, `~/.vibe-trading/imports`에 두거나, `VIBE_TRADING_ALLOWED_FILE_ROOTS`로 전용 디렉터리를 추가하세요. ### Web UI Settings Web UI Settings 페이지에서는 로컬 사용자가 LLM provider/model, Base URL, 생성 파라미터, reasoning effort, Tushare token 같은 선택적 시장 데이터 자격 증명을 업데이트할 수 있습니다. 설정은 `agent/.env`에 저장되며 provider 기본값은 `agent/src/providers/llm_providers.json`에서 로드됩니다. Settings 읽기는 부작용이 없습니다. `GET /settings/llm`과 `GET /settings/data-sources`는 `agent/.env`를 만들지 않고 프로젝트 상대 경로만 반환합니다. Settings 읽기와 쓰기는 자격 증명 상태를 노출하거나 자격 증명/런타임 환경을 업데이트할 수 있으므로 `API_AUTH_KEY`가 설정되어 있으면 인증이 필요합니다. 개발 모드에서 `API_AUTH_KEY`가 설정되지 않은 경우 settings 접근은 loopback 로컬 클라이언트에만 허용됩니다. --- ## 🔌 MCP 플러그인 Vibe-Trading은 MCP 호환 클라이언트용 22개 MCP 도구를 제공합니다. stdio 서브프로세스로 실행 — 서버 설정 불필요. **22개 중 21개 도구는 API 키 없이 작동**(HK/US/크립토). `run_swarm`만 LLM 키가 필요합니다.

Claude Desktop

`claude_desktop_config.json`에 추가: ```json { "mcpServers": { "vibe-trading": { "command": "vibe-trading-mcp" } } } ```

OpenClaw

`~/.openclaw/config.yaml`에 추가: ```yaml skills: - name: vibe-trading command: vibe-trading-mcp ```

Cursor / Windsurf / 기타 MCP 클라이언트

```bash vibe-trading-mcp # stdio (default) vibe-trading-mcp --transport sse # 웹 클라이언트용 SSE ```

**제공 MCP 도구(22):** `list_skills`, `load_skill`, `backtest`, `factor_analysis`, `analyze_options`, `pattern_recognition`, `get_market_data`, `web_search`, `read_url`, `read_document`, `read_file`, `write_file`, `analyze_trade_journal`, `extract_shadow_strategy`, `run_shadow_backtest`, `render_shadow_report`, `scan_shadow_signals`, `list_swarm_presets`, `run_swarm`, `get_swarm_status`, `get_run_result`, `list_runs`.

ClawHub에서 설치(한 줄)

```bash npx clawhub@latest install vibe-trading --force ``` > 외부 API를 참조하는 스킬이 있어 VirusTotal 자동 스캔이 트리거되므로 `--force`가 필요합니다. 코드는 완전 오픈소스이며 검토 가능합니다. 이 명령은 스킬과 MCP 설정을 에이전트의 스킬 디렉터리에 다운로드합니다. 클론이 필요 없습니다. ClawHub에서 보기: [clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills/vibe-trading)

OpenSpace — 자가 진화 스킬

모든 74개 금융 스킬은 [open-space.cloud](https://open-space.cloud)에 게시되어 OpenSpace의 자가 진화 엔진을 통해 스스로 발전합니다. OpenSpace와 함께 사용하려면 두 MCP 서버를 에이전트 설정에 추가하세요: ```json { "mcpServers": { "openspace": { "command": "openspace-mcp", "toolTimeout": 600, "env": { "OPENSPACE_HOST_SKILL_DIRS": "/path/to/vibe-trading/agent/src/skills", "OPENSPACE_WORKSPACE": "/path/to/OpenSpace" } }, "vibe-trading": { "command": "vibe-trading-mcp" } } } ``` OpenSpace는 모든 74개 스킬을 자동으로 탐지하여 자동 수정, 자동 개선, 커뮤니티 공유를 활성화합니다. OpenSpace 연결 에이전트에서 `search_skills("finance backtest")`로 Vibe-Trading 스킬을 검색하세요.

--- ## 📁 프로젝트 구조

클릭하여 펼치기

``` Vibe-Trading/ ├── agent/ # Backend (Python) │ ├── cli.py # CLI 엔트리포인트 — 인터랙티브 TUI + 서브커맨드 │ ├── api_server.py # FastAPI 서버 — 실행, 세션, 업로드, 스웜, SSE │ ├── mcp_server.py # MCP 서버 — OpenClaw / Claude Desktop용 22개 도구 │ │ │ ├── src/ │ │ ├── agent/ # ReAct 에이전트 코어 │ │ │ ├── loop.py # 5계층 압축 + 읽기/쓰기 도구 배치 처리 │ │ │ ├── context.py # 시스템 프롬프트 + 영구 메모리 자동 리콜 │ │ │ ├── skills.py # 스킬 로더(74 번들 + 사용자 CRUD 생성) │ │ │ ├── tools.py # 도구 기본 클래스 + 레지스트리 │ │ │ ├── memory.py # 실행별 경량 워크스페이스 상태 │ │ │ ├── frontmatter.py # 공유 YAML frontmatter 파서 │ │ │ └── trace.py # 실행 트레이스 기록기 │ │ │ │ │ ├── memory/ # 크로스세션 영구 메모리 │ │ │ └── persistent.py # 파일 기반 메모리 (~/.vibe-trading/memory/) │ │ │ │ │ ├── tools/ # 27개 자동 탐지 에이전트 도구 │ │ │ ├── backtest_tool.py # 백테스트 실행 │ │ │ ├── remember_tool.py # 크로스세션 메모리 (저장/리콜/삭제) │ │ │ ├── skill_writer_tool.py # 스킬 CRUD (저장/패치/삭제/파일) │ │ │ ├── session_search_tool.py # FTS5 크로스세션 검색 │ │ │ ├── swarm_tool.py # 스웜 팀 실행 │ │ │ ├── web_search_tool.py # DuckDuckGo 웹 검색 │ │ │ └── ... # bash, 파일 I/O, 팩터 분석, 옵션 등 │ │ │ │ │ ├── skills/ # 8개 카테고리의 74개 금융 스킬(SKILL.md 각각) │ │ ├── swarm/ # 스웜 DAG 실행 엔진 │ │ │ └── presets/ # 29개 스웜 프리셋 YAML 정의 │ │ ├── session/ # 멀티턴 채팅 + FTS5 세션 검색 │ │ └── providers/ # LLM 제공자 추상화 │ │ │ └── backtest/ # 백테스트 엔진 │ ├── engines/ # 7개 엔진 + 크로스마켓 복합 엔진 + options_portfolio │ ├── loaders/ # 6개 소스: tushare, okx, yfinance, akshare, ccxt, futu │ │ ├── base.py # DataLoader Protocol │ │ └── registry.py # 레지스트리 + 자동 폴백 체인 │ └── optimizers/ # MVO, equal vol, max div, risk parity │ ├── frontend/ # Web UI (React 19 + Vite + TypeScript) │ └── src/ │ ├── pages/ # Home, Agent, RunDetail, Compare │ ├── components/ # chat, charts, layout │ └── stores/ # Zustand 상태 관리 │ ├── Dockerfile # 멀티 스테이지 빌드 ├── docker-compose.yml # 원커맨드 배포 ├── pyproject.toml # 패키지 설정 + CLI 엔트리포인트 └── LICENSE # MIT ```

--- ## 🏛 생태계 Vibe-Trading은 **[HKUDS](https://github.com/HKUDS)** 에이전트 생태계의 일부입니다:

ClawTeam
_{에이전트 스웜 인텔리전스}

NanoBot
_{초경량 개인 AI 어시스턴트}

CLI-Anything
_{모든 소프트웨어를 에이전트 네이티브로}

OpenSpace
_{자가 진화 AI 에이전트 스킬}

--- ## 🗺 로드맵 > 단계적으로 배포합니다. 작업이 시작되면 항목이 [Issues](https://github.com/HKUDS/Vibe-Trading/issues)로 이동합니다. | Phase | Feature | Status | |-------|---------|--------| | **Research Autopilot** | 야간 리서치 루프: 가설 → 데이터 수집 → 백테스트 → 근거 리포트 | In Progress | | **Data Bridge** | 사용자 데이터 연결: 로컬 CSV/Parquet/SQL 커넥터 + schema mapping | Planned | | **Options Lab** | 변동성 서피스, 그릭스 대시보드, 페이오프/시나리오 탐색기 | Planned | | **Portfolio Studio** | 리스크 엑스레이, 제약 조건, 턴오버 고려 옵티마이저, 리밸런싱 노트 | Planned | | **Alpha Zoo** | Alpha101 / Alpha158 / Alpha191 팩터 라이브러리와 스크리닝 + IC 테스트 | Planned | | **Research Delivery** | Slack / Telegram / 이메일형 채널로 예약 브리프 전달 | Planned | | **Trust Layer** | 재현 가능한 run card: 도구 추적, 데이터 소스, 가정, 인용 | Planned | | **Community** | 공유 가능한 skills, presets, strategy cards | Exploring | --- ## 기여하기 기여를 환영합니다! 가이드는 [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요. **Good first issues**는 [`good first issue`](https://github.com/HKUDS/Vibe-Trading/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) 라벨로 표시되어 있습니다 — 선택해 바로 시작해 보세요. 더 큰 기여를 원하나요? 위 [로드맵](#-로드맵)을 확인하고 시작 전에 이슈를 열어 논의해주세요. --- ## 기여자 Vibe-Trading에 기여해 주신 모든 분들께 감사드립니다!

--- ## 면책조항 Vibe-Trading은 리서치, 시뮬레이션, 백테스트 용도입니다. 투자 조언이 아니며 실거래를 실행하지 않습니다. 과거 성과는 미래 수익을 보장하지 않습니다. ## 라이선스 MIT License — [LICENSE](LICENSE) 참조 --- ## 스타 히스토리 [![Star History Chart](https://api.star-history.com/svg?repos=HKUDS/Vibe-Trading&type=Date)](https://star-history.com/#HKUDS/Vibe-Trading&Date) ---

방문해 주셔서 감사합니다 Vibe-Trading ✨