virattt/ai-hedge-fund

AI 기반 헤지펀드 개념 증명으로, LLM을 활용한 투자 전략 시뮬레이션 및 백테스트 도구

완성 앱맘대로 써도 됨 · MITPython난이도
62,993+89이번 주0
11,076포크163이슈

중간맛 분석

Python 기반의 터미널 앱으로, 대화형 인터페이스에서 펀드를 구성하거나 명령어로 백테스트를 실행할 수 있습니다. 요구사항은 Financial Datasets 키와 LLM 제공자(Anthropic, OpenAI, DeepSeek, Google, xAI, Kimi 중 택일) 키입니다. 설치는 pipx install aihf 한 줄로 끝나고, 마법 파일(mandate YAML)로 전략을 정의한 후 aihf --backtest 명령어로 즉시 과거 수익률 곡선을 확인할 수 있습니다. 복잡한 설정 없이 첫 실행 시 대화형으로 필요한 키를 입력받아 저장합니다.

이런 레포예요

이럴 때 쓰면 좋아요

  • AI 기반 포트폴리오 전략 시뮬레이션 및 성과 검증
  • 투자 의사결정에 LLM을 활용하는 방식 학습 및 실험
  • 역사 데이터에 대한 알고리즘 트레이딩 아이디어 백테스트

핵심 기능

LLM 기반 자동 투자 전략 생성 및 실행과거 데이터 백테스트 및 수익률 곡선 시각화Mandate 파일로 펀드 구조·전략·리밸런싱 주기 선언형 정의

대안 대비 차별점

기존 정적 백테스트 라이브러리와 달리 LLM이 실시간 시장 데이터를 해석하여 동적 투자 판단을 내리므로, 전통적 규칙 기반 시스템보다 더 유연한 AI 전략 실험이 가능합니다.

먹어본 사람들

실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.

시식평 · 먹어본 사람 한마디

아직 시식평이 없어요. 먹어보셨다면 첫 한마디를 남겨주세요.

다른 레포 시식평 구경하기 →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

이 레포, 해먹는 법

처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.

준비물

  • Financial Datasets API 키
  • LLM API 키(Anthropic, OpenAI, DeepSeek, Google, xAI, Kimi 중 하나)
  • Python 3.x 환경(pipx 또는 uv 권장)

바로 차려먹기Python (uv)

깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.

git clone --depth 1 https://github.com/virattt/ai-hedge-fund.git &&
cd ai-hedge-fund &&
uv sync

uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.

코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.

README가 안내하는 자세한 단계 보기
  1. pipx를 사용해 aihf를 설치합니다.
pipx install aihf
  1. 대화형 터미널 앱을 실행합니다.
aihf
  1. (선택사항) 저장된 펀드 mandate 파일을 명시적으로 백테스트합니다.
aihf ~/.hedge-fund/mandates/example.yaml --tickers AAPL,MSFT --backtest
  1. (개발 환경 구성) 소스에서 직접 실행하려면 리포지토리를 클론합니다.
git clone https://github.com/virattt/ai-hedge-fund.git
cd ai-hedge-fund
  1. Poetry로 의존성을 설치합니다.
poetry install
poetry run aihf
  1. 테스트를 실행합니다.
poetry run pytest hedge_fund

깃밥트라이로 맛보기

받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.

터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.

npx gitbap-try virattt/ai-hedge-fund

Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →

별 추이 · 7일

62,993+89 / 7일

활용성 · 따라 만들기 좋은가

샘플 점수 34/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2024년 생성

이런 레포, 매주 이메일로 받아보실래요?

매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.

내 레포인가요? README에 깃밥 배지 달기
[![깃밥](https://www.gitbap.com/badge/virattt/ai-hedge-fund.svg)](https://www.gitbap.com/r/virattt/ai-hedge-fund)
🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기