Vibe-Trading
- 추천0
- GitHub 별38K
- 금융라이선스MIT
말로 지시하는 개인 트레이딩 에이전트. 시장 리서치 · 백테스트 · 퀀트 연구 · 모의 거래를 하고 증권사 연동까지 지원해요
요약
말로 지시하는 개인 트레이딩 에이전트. 시장 리서치 · 백테스트 · 퀀트 연구 · 모의 거래를 하고 증권사 연동까지 지원해요
설명
![]()
Vibe-Trading: 나만의 트레이딩 에이전트
명령 하나로 내 에이전트에 종합 트레이딩 능력을 더하세요
GitHub 주제별 별 순위(2026년 11월 4일 기준): 백테스팅 1위 · 알고리즘 트레이딩 3위 · 퀀트 금융 4위
📰 최근 소식
- 2026-11-15 📡 통합 시장 데이터 게이트웨이와 바로 쓰는 CSV — 과거 봉 데이터와 미국 옵션 스냅샷이 출처 대체(fallback), 공유 캐시, 동시 실행 제한을 갖춘 로컬 데이터 게이트웨이를 함께 씁니다. 응답은 출처 · 통화 · 가격 조정 메타데이터와 범위 · 신선도 정보를 남깁니다. 에이전트의 시장 데이터 읽기는 JSON과 함께 CSV도 줍니다.
- 2026-11-14 🔌 통합 LLM 게이트웨이와 버전 확인 — 에이전트 · CLI · API · Swarm이 하나의 모델 목록과 설정 계층을 공유합니다. 웹 설정에서 새 버전을 확인할 수 있습니다.
- 2026-11-13 🛠️ 리서치 전달과 계산 도구 — 중단된 위원회 실행은 부분 결과를 보존하고 끝나지 않은 역할부터 이어 갈 수 있습니다. 옵션 랩과
options_payoff가 주식 + 옵션 전략을 계산하고 여러 대안을 한 번에 비교합니다. - 2026-11-05 🚀 v0.1.19 공개: 채팅을 넘어 이어지는 리서치(근거와 함께 버전이 있는 리서치 아티팩트 저장 · 수정), 이전 턴과 세션의 백테스트 재사용, 5분 단위 A주 모의 시뮬레이션 옵션, 아르헨티나(BYMA) 백테스트 등. 26명의 기여자가 병합 PR 116개를 보탰습니다.
✨ 핵심 기능
- 🔍 시장 리서치: 시세 · 공시 · ETF 보유 종목을 살펴보고, DCF와 동종 업체 배수로 기업 가치를 평가하며, 실적을 추적하고 장 시작 전 브리핑을 예약합니다.
- 🐝 리서치 팀: 주식 · 퀀트 · 암호화폐 · 리스크용 프리셋 팀 30개. 강세 논거 · 약세 논거 · 리스크 검토를 따라가고, Pixel Office에서 리서치 업무를 배정합니다.
- 📊 퀀트 랩: 5개 라이브러리의 알파 478개를 벤치마크하고, 여러 시장에서 백테스트하고 표본 밖(out-of-sample)으로 시험하며, 옵션 손익 · 그릭스 · 포트폴리오 위험을 모델링합니다.
- 👥 트레이딩과 포트폴리오: 증권사별 권한을 갖춘 커넥터 19개. 모의 체결을 추적하거나 지원되는 실거래에 한도를 설정하고, Shadow Account로 내 매매 규칙을 되돌려 봅니다.
💡 Vibe-Trading이란?
Vibe-Trading은 금융 질문을 리서치 보고서, 실행 가능한 백테스트, 모의 포트폴리오로 바꿔 줍니다. 지원되는 증권사에 내가 정하고 멈출 수 있는 위임 범위 안에서 실거래 주문을 실행하도록 승인할 수도 있습니다. 자금은 증권사에 그대로 있습니다.
⚡ 빠른 예시
vibe-trading init을 실행한 뒤에는 쉬운 영어로 백테스트를 부탁하거나, 터미널에서 기존 알파 라이브러리를 벤치마크할 수 있습니다.
vibe-trading run -p "Backtest a BTC-USDT 20/50 moving-average crossover for 2024. Compare it with buy-and-hold and report maximum drawdown."
vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025 --top 20
Run Detail을 열어 교차 전략과 보유(buy-and-hold)를 비교하고, 낙폭 뒤의 거래를 살펴보고, 실행 카드에서 데이터 출처를 확인하세요.
🧪 리서치 흐름
| 단계 | 교차 전략 예시에서 |
|---|---|
| 계획 | 프롬프트에서 거래 쌍, 기간, 이동평균, 벤치마크를 파악합니다. |
| 근거 확보 | BTC-USDT의 과거 봉을 가져옵니다. 결과를 해석하기 전에 출처와 날짜를 확인합니다. |
| 실행 | 전략을 쓰고 백테스트를 돌립니다. 실행 폴더에 전략, 거래, 자산 곡선이 남습니다. |
| 검증 | 결과를 보유 전략과 비교합니다. 수익과 함께 회전율, 낙폭, 검증 경고를 살펴봅니다. |
| 다시 보기 | 저장된 실행을 열거나 다른 매개변수로 후속 질문을 합니다. 날짜가 있는 리서치 결론을 저장하고 새 근거가 생기면 고칠 수도 있습니다. |
📡 데이터 출처와 스마트 대체
로더는 시장 데이터 출처 28곳을 지원합니다. source: "auto"이면 심볼로 시장을 추정해 설정된 출처를 차례로 시도합니다.
| 시장 | 요청을 채우는 방식 |
|---|---|
| A주와 홍콩 | Tencent로 시작합니다. 봉을 못 주면 Eastmoney, 그다음 그 시장의 나머지 출처를 시도합니다. |
| 미국 주식 | Yahoo로 시작합니다. Stooq와 Sina가 다음 두 출처입니다. |
| 암호화폐 | OKX, Binance, CCXT를 시도한 뒤 다른 출처로 넘어갑니다. |
| 선물 | 중국 계약은 AKShare나 로컬 봉을 쓸 수 있습니다. 해외 계약은 로컬 봉을 직접 제공하세요. |
출처를 직접 고를 수도 있습니다. 예를 들어 vibe-trading-ai[ashare]를 설치하면 일봉 A주용 토큰 없는 BaoStock 로더가 추가됩니다.
🔩 상세 기능
시장 리서치
| 기능 | 할 수 있는 일 |
|---|---|
| 공시와 보유 | 운용사의 SEC 13F 보유 내역을 분기별로 비교하거나 ETF의 기초 보유 종목까지 들여다봅니다. 모든 보유 보고서에는 보고 날짜가 있습니다. |
| 기업 가치 평가 | /dcf로 할인율과 영구 성장률에 따른 가치 변화를 봅니다. 동종 업체 배수는 /comps, 연결된 3개 재무제표 모델을 만들어 엑셀로 내보낼 수도 있습니다. |
| 논문과 문서 | arXiv와 OpenAlex에서 시그널을 찾고 저자의 정의를 확인한 뒤 내 종목군에서 시험합니다. 공시 · 스프레드시트 · 슬라이드를 올려 특정 항목을 질문합니다. |
| 종목 스크리닝 | Gildata를 켜면 시가총액으로 기업을 거르고 반기 매출을 한 번에 가져옵니다. |
퀀트 연구
| 기능 | 할 수 있는 일 |
|---|---|
| Alpha Zoo | Qlib · Alpha101 · GTJA와 학술 · 펀더멘털 라이브러리의 시그널을 벤치마크합니다. 기간별 정보 계수를 비교하고 결과가 워크포워드 시험을 견디는지 확인합니다. |
| 백테스트 엔진 | A주 가격 제한, 암호화폐 펀딩, 선물 증거금을 모델링합니다. 여러 시장 전략에는 공유 자본 풀을 쓰고 수익 뒤의 개별 체결을 살펴봅니다. |
| 옵션 랩 | 스프레드를 다리(leg)별로 만들고, 만기 손익을 그릭스와 비교하며, 현물 가격과 내재 변동성 변화에 포지션이 어떻게 반응하는지 봅니다. |
| 포트폴리오 위험 | 낙폭을 살피고, 위험가치(VaR)와 기대 부족액을 추정하며, Brinson 성과 기여로 배분과 종목 선택을 가릅니다. |
| 전략 추적 | 전략을 근거와 함께 등록하고 새 결과가 나올 때마다 샤프 지수나 팩터 정보 계수의 변화를 추적합니다. |
계좌와 트레이딩
| 기능 | 할 수 있는 일 |
|---|---|
| 포트폴리오 | 읽기 전용 증권사 보유 내역을 하나의 스냅샷으로 모읍니다. 목표 비중을 넣어 종목별 가치 변화를 미리 봅니다. |
| 모의 거래 | 저장된 계좌를 거래일 하나씩 진행하며 체결 · 현금 · NAV를 살핍니다. A주 장을 5분 단위로 되감아 재생할 수도 있습니다. |
| Shadow Account | 증권사의 거래 일지를 가져와 수수료와 매매 습관을 보고 실제 거래를 규칙 기반 재생과 비교합니다. |
| 증권사 연결 | CLI나 웹에서 연결을 만들고 읽기로 시험합니다. 지원되는 실거래 프로필은 활성화 전에 종목 · 주문 · 노출 한도를 정합니다. 킬 스위치가 실거래를 멈춥니다. |
증권사 지원 한눈에 보기
Read는 읽기 전용 프로필, Sim은 증권사 샌드박스나 로컬 시뮬레이션의 모의 주문, Live는 위임 범위 안의 실거래 주문입니다.
| 증권사 | Read | Sim | Live |
|---|---|---|---|
| alpaca | Yes | Yes | Yes |
| binance | Yes | Yes | Yes |
| dhan | Yes | Yes | — |
| etoro | Yes | Yes | Yes |
| futu | Yes | Yes | Yes |
| ibkr | Yes | — | — |
| kis | Yes | Yes | — |
| longbridge | Yes | Yes | — |
| mstock | Yes | — | — |
| mt5 | Yes | Yes | Yes |
| okx | Yes | Yes | Yes |
| robinhood | Yes | — | Yes |
| scalable | Yes | — | — |
| shoonya | Yes | Yes | — |
| tiger | Yes | Yes | Yes |
| toss | Yes | — | — |
| trading212 | Yes | — | — |
| upbit | Yes | Yes | — |
| zerodha | Yes | Yes | — |
🎬 데모
- 웹 · 프롬프트에서 백테스트까지: 전략 요청을 보내고 에이전트의 작업을 따라가며 결과 실행을 살펴봅니다.
- CLI · 대화형 터미널: 리서치 플레이북을 둘러보고 터미널에서 장 시작 전 브리핑을 엽니다.
🚀 빠른 시작
터미널. Python 3.11+로 패키지를 설치하고, 설정 마법사에서 모델 서비스를 고른 뒤 대화형 CLI를 엽니다.
pip install vibe-trading-ai
vibe-trading init
vibe-trading
웹 앱. Docker가 프런트엔드와 API를 http://localhost:8899에서 함께 제공합니다. 새로 받은 저장소에서는 컨테이너를 시작하기 전에 모델 서비스를 설정하세요.
git clone https://github.com/HKUDS/Vibe-Trading.git
cd Vibe-Trading
cp agent/.env.example agent/.env
# Set your provider and API key in agent/.env.
docker compose up --build
PyPI 패키지에는 CLI, API, MCP 서버가 들어 있습니다. 프런트엔드 개발 환경이나 로컬 모델은 설치 안내를 보세요.
🖥 CLI 참조
vibe-trading을 시작하면 대화형 터미널이 열립니다. 프롬프트에서 /help를 입력해 명령을 둘러보거나 리서치 중에 다음 단축키를 쓰세요.
| 명령 | 용도 |
|---|---|
/model | 세션의 서비스나 모델을 바꿉니다. |
/history | 이전 대화를 둘러보고 이어 갑니다. |
/show <run> | 저장된 실행의 결과를 살펴봅니다. |
/pine | 현재 전략을 Pine Script 지표로 내보냅니다. |
셸에서 vibe-trading alpha list는 팩터 라이브러리를, vibe-trading playbook list는 예약 리서치 템플릿을 보여 줍니다.
💡 예시
- 종목 비교. "2024년 AAPL과 MSFT를 비교해 줘. 수익률 차이가 가장 큰 달은 언제야?"라고 묻고, 나중에
/history로 대화를 이어 갑니다. - 내 거래 검토.
/journal로 내보낸 거래 내역을 분석하고,/shadow로 내 거래를 규칙 기반 대안과 비교합니다. - 투자 위원회 운영. 종목을 고르고 강세와 약세 논거를 따라 최종 보고서까지 갑니다.
vibe-trading --swarm-run investment_committee '{"target":"TSLA","market":"US"}'
🌐 API 서버
vibe-trading serve --port 8899로 로컬 서버를 시작합니다. 두 번째 터미널에서 curl http://localhost:8899/runs로 저장된 실행을 나열하고, 돌려받은 ID로 GET /runs/{run_id}를 호출해 결과를 살펴봅니다.
| HTTP로 리서치 세션을 실행하려면 | 엔드포인트 |
|---|---|
| 대화 만들기 | POST /sessions |
| 리서치 질문 보내기 | POST /sessions/{id}/messages |
| 진행 상황을 실시간으로 따라가기 | GET /sessions/{id}/events |
http://localhost:8899/docs를 열어 엔드포인트를 직접 시험해 볼 수 있습니다. 인증된 클라이언트는 Authorization: Bearer 헤더에 API 키를 보냅니다.
🔌 MCP 플러그인
MCP 클라이언트가 같은 패키지를 stdio로 띄울 수 있습니다. Claude Desktop의 claude_desktop_config.json에 이 항목을 넣고 클라이언트를 다시 켠 뒤 list_skills를 호출하세요.
{
"mcpServers": {
"vibe-trading": { "command": "vibe-trading-mcp" }
}
}
다른 클라이언트나 출력 폴더 지정은 MCP 설정 문서를 보세요.
🏛 생태계
Vibe-Trading은 HKUDS 에이전트 생태계의 일부입니다.
- NanoBot: 초경량 개인 AI 비서
- AI-Trader: 에이전트 네이티브 시그널 · 카피 트레이딩 플랫폼
- CLI-Anything: 모든 소프트웨어를 에이전트 네이티브로
- OpenSpace: 스스로 진화하는 AI 에이전트 스킬
- ClawTeam: 에이전트 스웜 지능
🗺 로드맵
| 영역 | 지금 가능한 것 | 다음 |
|---|---|---|
| 모의 거래 | 일 단위 계좌가 세션 사이에 현금 · 체결 · NAV를 유지합니다. 별도 시뮬레이션이 A주 장을 5분 단위로 재생합니다. | 선택형 거래량 비중 체결(#2128). |
| 리서치 | 실행 카드가 끝난 백테스트의 지표와 근거를 기록합니다. 날짜가 있는 리서치 아티팩트가 수정 이력을 보관하고 검색됩니다. | 리서치 아티팩트의 구조화된 재무 사실(#2164). |
| 옵션 랩 | 다중 다리 손익, 그릭스, 현물 × IV 시나리오를 살펴봅니다. | /options의 대화형 변동성 곡면 격자. |
기여하기
좋은 첫 이슈(good first issue)를 고르거나 큰 변경은 이슈를 열어 논의하세요. 기여 안내에 로컬 설정과 풀 리퀘스트 전에 돌릴 점검이 있습니다.
기여자
Vibe-Trading에 기여해 주신 모든 분께 감사드립니다.
더 알아보기
전체 뉴스 보관소, 변경 이력(CHANGELOG), 증권사별 권한 표, 데이터 출처 참조, v0.1.19 기여자 목록은 저장소 README에 있습니다.
⚠️ 투자 안내 이 소개는 오픈소스 도구를 알리기 위한 글이며 투자 권유가 아닙니다. 이 도구는 증권사 계정에 연결해 실거래 주문까지 낼 수 있으니 먼저 모의 거래로 확인하세요. 이 도구가 내놓은 결과를 따른 매매의 손실 책임은 사용자에게 있습니다.
저장소: HKUDS/Vibe-Trading · 라이선스: MIT
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0