본문으로 건너뛰기
오픈소스 전체 목록

Vibe-Trading

  • 추천0
  • GitHub 별38K
  • 금융라이선스MIT

말로 지시하는 개인 트레이딩 에이전트. 시장 리서치 · 백테스트 · 퀀트 연구 · 모의 거래를 하고 증권사 연동까지 지원해요

원본:HKUDS/Vibe-Trading

요약

말로 지시하는 개인 트레이딩 에이전트. 시장 리서치 · 백테스트 · 퀀트 연구 · 모의 거래를 하고 증권사 연동까지 지원해요

설명

Vibe-Trading 로고

Vibe-Trading: 나만의 트레이딩 에이전트

명령 하나로 내 에이전트에 종합 트레이딩 능력을 더하세요

Star History: GitHub 트렌딩 Trendshift: 일간 순위 Star History: 전체 별 순위

Python FastAPI React PyPI 라이선스 Discord

GitHub 주제별 별 순위(2026년 11월 4일 기준): 백테스팅 1위 · 알고리즘 트레이딩 3위 · 퀀트 금융 4위

pip install vibe-trading-ai

📰 최근 소식

  • 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 ZooQlib · Alpha101 · GTJA와 학술 · 펀더멘털 라이브러리의 시그널을 벤치마크합니다. 기간별 정보 계수를 비교하고 결과가 워크포워드 시험을 견디는지 확인합니다.
백테스트 엔진A주 가격 제한, 암호화폐 펀딩, 선물 증거금을 모델링합니다. 여러 시장 전략에는 공유 자본 풀을 쓰고 수익 뒤의 개별 체결을 살펴봅니다.
옵션 랩스프레드를 다리(leg)별로 만들고, 만기 손익을 그릭스와 비교하며, 현물 가격과 내재 변동성 변화에 포지션이 어떻게 반응하는지 봅니다.
포트폴리오 위험낙폭을 살피고, 위험가치(VaR)와 기대 부족액을 추정하며, Brinson 성과 기여로 배분과 종목 선택을 가릅니다.
전략 추적전략을 근거와 함께 등록하고 새 결과가 나올 때마다 샤프 지수나 팩터 정보 계수의 변화를 추적합니다.

계좌와 트레이딩

기능할 수 있는 일
포트폴리오읽기 전용 증권사 보유 내역을 하나의 스냅샷으로 모읍니다. 목표 비중을 넣어 종목별 가치 변화를 미리 봅니다.
모의 거래저장된 계좌를 거래일 하나씩 진행하며 체결 · 현금 · NAV를 살핍니다. A주 장을 5분 단위로 되감아 재생할 수도 있습니다.
Shadow Account증권사의 거래 일지를 가져와 수수료와 매매 습관을 보고 실제 거래를 규칙 기반 재생과 비교합니다.
증권사 연결CLI나 웹에서 연결을 만들고 읽기로 시험합니다. 지원되는 실거래 프로필은 활성화 전에 종목 · 주문 · 노출 한도를 정합니다. 킬 스위치가 실거래를 멈춥니다.

증권사 지원 한눈에 보기

Read는 읽기 전용 프로필, Sim은 증권사 샌드박스나 로컬 시뮬레이션의 모의 주문, Live는 위임 범위 안의 실거래 주문입니다.

증권사ReadSimLive
alpacaYesYesYes
binanceYesYesYes
dhanYesYes—
etoroYesYesYes
futuYesYesYes
ibkrYes——
kisYesYes—
longbridgeYesYes—
mstockYes——
mt5YesYesYes
okxYesYesYes
robinhoodYes—Yes
scalableYes——
shoonyaYesYes—
tigerYesYesYes
tossYes——
trading212Yes——
upbitYesYes—
zerodhaYesYes—

🎬 데모

🚀 빠른 시작

터미널. 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에 기여해 주신 모든 분께 감사드립니다.

Vibe-Trading 기여자 아바타

더 알아보기

전체 뉴스 보관소, 변경 이력(CHANGELOG), 증권사별 권한 표, 데이터 출처 참조, v0.1.19 기여자 목록은 저장소 README에 있습니다.


⚠️ 투자 안내 이 소개는 오픈소스 도구를 알리기 위한 글이며 투자 권유가 아닙니다. 이 도구는 증권사 계정에 연결해 실거래 주문까지 낼 수 있으니 먼저 모의 거래로 확인하세요. 이 도구가 내놓은 결과를 따른 매매의 손실 책임은 사용자에게 있습니다.

저장소: HKUDS/Vibe-Trading · 라이선스: MIT

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0