개요
Vibe-Trading은 LLM으로 구동되는 개인 거래 에이전트로, 다중 에이전트 오케스트레이션과 증권사 커넥터를 통합하며 백테스팅, 실시간 시세 및 리스크 관리를 지원합니다. 명령줄, REST API, MCP 및 웹 인터페이스를 제공하며, 하나의 명령으로 거래 전략을 배포할 수 있습니다.
README 미리보기
\n English | 中文 | 日本語 | 한국어 | العربية\n\n\n\n \n\n\nVibe-Trading: Your Personal Trading Agent\n\n\n One Command to Empower Your Agent with Comprehensive Trading Capabilities\n\n\n\n \n\n\n\n \n \n \n \n \n \n \n \n \n\n\n\n Website · \n Docs · \n News · \n Features · \n Shadow Account · \n Demo · \n Quick Start · \n Examples · \n API / MCP · \n Roadmap · \n Contributing\n\n\n\n \n\n\n---\n\n## 📰 News\n\n- **2026-06-03** 🧹 **Community triage + trace correlation**: Tool-call trace entries now carry the originating `call_id`, so a `tool_result` can be matched back to its `tool_call` when replaying a run trace — arg previews stay truncated to keep trace files small ([#168](https://github.com/HKUDS/Vibe-Trading/pull/168), thanks @zwrong). Source comments no longer point at an internal-only docs path that external contributors couldn't find ([#166](https://github.com/HKUDS/Vibe-Trading/issues/166), thanks @jaleelpersonal). Also clarified that the `langchain-community` resolver warning on install is a harmless leftover-package notice, not a failure ([#167](https://github.com/HKUDS/Vibe-Trading/issues/167)), and scoped Gemini 2.5/3.0 `thoughtSignature` round-tripping for function calls as a `help wanted` task with a full fix plan ([#170](https://github.com/HKUDS/Vibe-Trading/issues/170), thanks @jliu6789).\n- **2026-06-02** 🔌 **Six new broker connectors (Tiger / Longbridge / Alpaca / OKX / Binance / Futu)**: The connector-first trading layer gains a direct-SDK transport alongside IBKR (local) and Robinhood (MCP). Each connector exposes read-only account / positions / orders / quote / history **plus paper-account order placement** — test your strategies across these broker paper accounts. Five of them (Tiger, Alpaca, OKX, Binance, Futu) also support **bounded, mandate-ga
FAQ (4)
문제 해결vibe-trading에서 DeepSeek v4 pro API 키를 사용할 때 401 오류가 반환되는 이유는 무엇인가요?
401 오류는 LLM 제공자가 올바르게 구성되지 않았음을 의미합니다. .env 파일(가급적 ~/.vibe-trading/.env)에 다음이 포함되어 있는지 확인하세요:
LANGCHAIN_PROVIDER=deepseek
LANGCHAIN_MODEL_NAME=deepseek-v4-pro
DEEPSEEK_API_KEY=sk-your-deepseek-official-api-key
DEEPSEEK_BASE_URL=https://api.deepseek.com/v1
TIMEOUT_SECONDS=2400중요:
- LANGCHAIN_PROVIDER는 반드시 deepseek여야 하며, openrouter가 아니어야 합니다.
- OpenRouter 키와 DeepSeek 키를 혼용하지 마세요.
- Vibe-trading은 먼저 ~/.vibe-trading/.env를 읽습니다. 해당 파일이 존재하면 agent/.env 대신 그 파일을 업데이트하세요.
문제 해결Vibe-Trading CLI swarm이 '429 billing_not_active' 오류와 함께 실패하는 이유는 무엇인가요?
스웜 워커는 Codex나 단일 태스크 실행에서 사용하는 것과 별도로 자체 LLM 프로바이더 구성을 사용합니다. CLI swarm 명령어는 워크플로우를 시작하지만, 환경 변수(예: agent/.env 파일 또는 셸의 LANGCHAIN_PROVIDER, LANGCHAIN_MODEL_NAME, DEEPSEEK_API_KEY)를 통해 설정된 프로바이더 계정이 활성화되지 않았거나 결제 설정이 되어 있지 않으면 내부 워커가 실패합니다. 해결하려면 agent/.env 파일을 확인하고 올바른 API 키가 설정되어 있는지, 프로바이더 계정이 활성화되어 있고 결제가 활성화되어 있는지 확인하세요. 그런 다음 swarm 명령어를 다시 실행하세요.
문제 해결Vibe-Trading에서 에이전트가 최대 반복 횟수에 도달하면 'Execution failed: unknown'이 표시되는 이유는 무엇인가요?
이는 알려진 버그(issue #114)로, 에이전트 루프가 max_iterations를 소진할 때 세션 채팅에 실제 실패 이유가 표시되지 않습니다. 실제 오류는 실행의 state.json 파일에 저장됩니다. 해결 방법: 실행 디렉터리(예: data/runs/<run_id>/)를 찾아 state.json의 reason 필드를 확인하세요: grep reason data/runs/*/state.json. 영구적인 수정은 보류 중입니다. 업데이트를 위해 저장소를 추적하세요.
방법A-share 백테스팅을 위해 FinRL에서 mootdx를 데이터 소스로 추가하는 방법은?
FinRL은 아직 내장 mootdx 지원을 포함하지 않습니다 (다음 릴리스에서 계획됨). 임시 해결 방법: (1) agent/backtest/loaders/로 이동, (2) akshare.py를 mootdx.py로 복사, (3) mootdx 라이브러리를 통해 데이터를 가져오도록 로더를 조정 (TCP 직접 연결, 인증 불필요, IP 차단 없음). 예: market.get_k_data()를 호출하여 K-line 데이터를 얻기 위해 mootdx 사용. MCP 기반 통합의 경우, MCP 서버를 통해 mootdx를 호출하도록 에이전트를 확장. 전체 공식 통합은 이 이슈에서 추적됩니다.