월스트리트 엘리트들이 AI를 사용하여 수백만 달러를 벌어들이는 방법에 대해 궁금해 본 적이 있나요? **AI 헤지펀드** 프로젝트를 사용하면 한 푼도 위험 부담 없이 자동화된 거래의 세계로 뛰어들 수 있습니다. GitHub의 이 오픈 소스 보물은 워렌 버핏과 캐시 우드 같은 전설적인 인물에게서 영감을 받은 AI 에이전트로 구동되는 헤지펀드를 시뮬레이션할 수 있게 해줍니다. 저는 이 프로젝트의 거래 전략을 탐색하는 데 푹 빠졌고, 이 튜토리얼에서는 자신만의 **AI 헤지펀드**를 설정하고, 애플과 마이크로소프트 같은 주식으로 거래 시뮬레이션을 실행하며, 이 똑똑한 에이전트들의 내부를 들여다보는 방법을 보여드리겠습니다. 금융 박사 학위는 필요 없습니다. 호기심과 노트북만 있으면 됩니다! 헤지펀드 매니저 역할을 할 준비가 되셨나요? 시작해 봅시다!
AI 헤지펀드란 무엇인가요? 당신의 가상 거래 팀
**AI 헤지펀드**는 AI 에이전트를 사용하여 거래 결정을 내리는 헤지펀드를 시뮬레이션하는 GitHub의 오픈 소스 프로젝트입니다. 각 에이전트가 전문 분야를 가지고 실제 투자 전문가를 모방하는 디지털 드림팀이라고 생각할 수 있습니다. 교육 목적으로 구축되었으며, GPT-4o 또는 Llama 3와 같은 대규모 언어 모델(LLM)을 사용하여 금융 데이터를 분석하고 거래를 시뮬레이션합니다. 실제 돈은 관련되지 않습니다. 주요 기능은 다음과 같습니다.
- 전문화된 에이전트: 기본 분석, 기술 분석, 센티멘트 분석, 리스크 관리자, 포트폴리오 관리자가 데이터를 분석하고 결정을 내립니다.
- 데이터 소스: Financial Datasets API를 통해 AAPL, MSFT, NVDA, GOOGL, TSLA와 같은 주식의 무료 금융 데이터를 가져옵니다.
- 사용자 정의 가능: 클라우드 기반 LLM(OpenAI, Groq) 또는 Ollama를 통한 로컬 모델로 실행할 수 있습니다.
- 시뮬레이션: 거래 전략이 어떻게 수행되었을지 확인하기 위해 백테스트를 실행합니다.
2천 개 이상의 스타를 받으며, AI가 헤지펀드를 어떻게 변화시키고 있는지 배우는 데 인기를 얻고 있습니다. 월스트리트 전문가보다 더 똑똑하게 거래하도록 설정해 봅시다!

AI 헤지펀드 환경 설정하기
**AI 헤지펀드**를 실행하기 전에 시스템을 준비해 봅시다. 이것은 초보자 친화적이며, 각 단계를 안내해 드리겠습니다.
1. 시스템 요구 사항 확인:
- OS: Windows (WSL2 포함), macOS 또는 Linux (Ubuntu 20.04+ 권장).
- 소프트웨어:
- Python 3.10 (
python3 --version
으로 확인). - Git (
git --version
으로 확인). - Ollama용 Docker CLI 또는 Docker Desktop (선택 사항, 로컬 LLM용).
- Windows를 사용 중이라면 PowerShell(관리자 권한)에서
wsl --install
을 실행하여 WSL2를 설치하고 재부팅하세요. 빠진 것이 있나요? 지금 python.org 또는 git-scm.com에서 설치하세요.
2. Poetry 설치: Poetry는 Python 종속성을 관리합니다. 설치 방법:
curl -sSL https://install.python-poetry.org | python3 -
poetry --version
으로 확인합니다 (예: 1.8.0). 필요한 경우 Poetry를 PATH에 추가합니다: export PATH="$HOME/.local/bin:$PATH"
.
3. API 키 가져오기:
- OpenAI: GPT-4o 접근을 위해 platform.openai.com에서 가입하세요. API 키를 복사합니다.
- Financial Datasets: 무료 주식 데이터(AAPL, MSFT 등)를 위해 financialdatasets.ai에서 등록하세요. 키를 복사합니다.
- 선택 사항: 다른 LLM을 위한 Groq (groq.com) 또는 Anthropic (anthropic) 키, 또는 로컬 모델을 위한 Ollama.
4. 프로젝트 폴더 생성: 정리된 상태를 유지합니다:
mkdir ai-hedge-fund
cd ai-hedge-fund
AI 헤지펀드 설치하기
이제 **AI 헤지펀드** 프로젝트를 클론하고 설정해 봅시다. 빠르고 거래 시뮬레이션을 준비할 수 있습니다.
1. 저장소 클론: GitHub에서 코드를 가져옵니다:
git clone https://github.com/virattt/ai-hedge-fund.git
cd ai-hedge-fund
에이전트 스크립트와 도구를 포함하여 프로젝트(~50MB)를 가져옵니다.
2. 종속성 설치: Poetry를 사용하여 필요한 라이브러리를 설치합니다:
poetry install
이렇게 하면 pandas
, requests
, LLM SDK와 같은 Python 패키지가 설정됩니다. 1~2분 정도 소요됩니다.
3. API 키 구성: 키를 저장할 .env
파일을 생성합니다:
cp .env.example .env
텍스트 편집기(예: nano .env
)로 .env
파일을 편집하고 다음 내용을 추가합니다:
# openai에서 호스팅하는 LLM 실행용 (gpt-4o, gpt-4o-mini 등)
# https://platform.openai.com/ 에서 OpenAI API 키를 가져옵니다.
OPENAI_API_KEY=your-openai-api-key
# groq에서 호스팅하는 LLM 실행용 (deepseek, llama3 등)
# https://groq.com/ 에서 Groq API 키를 가져옵니다.
GROQ_API_KEY=your-groq-api-key
# 헤지펀드 구동을 위한 금융 데이터 가져오기용
# https://financialdatasets.ai/ 에서 Financial Datasets API 키를 가져옵니다.
FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key
저장하고 종료합니다. 로컬 LLM의 경우 OpenAI를 건너뛰고 Ollama를 사용합니다 (아래 참조).
4. 선택 사항: 로컬 LLM을 위한 Ollama 설정: Llama 3와 같은 모델을 로컬에서 실행하고 싶으신가요? Ollama 설치:
curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3
Ollama 시작: ollama serve
. Llama 3는 약 5GB를 사용합니다. Docker를 통해 실행하는 경우 Docker가 설치되어 있는지 확인하세요 (docker.com).

AI 헤지펀드 실행하기: 거래 시뮬레이션
**AI 헤지펀드**를 실행하고 애플(AAPL)과 마이크로소프트(MSFT) 같은 주식에 대한 거래를 시뮬레이션해 봅시다. AI 에이전트들이 어떻게 협력하는지 볼 수 있습니다.
1. 시뮬레이션 실행: ai-hedge-fund
폴더에서 다음을 실행합니다:
poetry run python src/main.py --ticker AAPL,MSFT
또는 로컬 LLM의 경우:
poetry run python src/main.py --ticker AAPL,MSFT --ollama
이 명령어는 다음을 수행합니다:
- AAPL과 MSFT를 대상으로 합니다 (Financial Datasets의 무료 데이터).
- AI 에이전트를 사용하여 기본 분석(예: P/E 비율), 기술 분석(예: 이동 평균), 센티멘트 분석(예: 뉴스), 리스크를 분석합니다.
- 거래를 시뮬레이션하고 결정을 출력합니다.
2. 어떤 일이 일어나나요?: 에이전트들이 협력합니다:
- 기본 분석 에이전트: AAPL의 매출 성장과 MSFT의 현금 흐름을 확인합니다.
- 기술 분석 에이전트: 매수/매도 신호를 위해 50일 이동 평균을 분석합니다.
- 센티멘트 분석 에이전트: 긍정적/부정적 분위기(예: "애플, 새 아이폰 출시")에 대한 뉴스를 스캔합니다.
- 리스크 관리자: 큰 손실을 피하기 위해 포지션 한도를 설정합니다.
- 포트폴리오 관리자: 신호에 따라 AAPL 주식 100주를 매수하고 MSFT를 보유하기로 결정합니다.

결과 보기: 터미널에서 거래 결정, 확률, 백테스트 결과를 확인하세요. 로그는 src/logs/
에 저장됩니다.
3. 백테스터 실행: 다음 명령어를 사용합니다:
poetry run python src/backtester.py --ticker AAPL,MSFT,NVDA
샘플 출력:

특정 기간에 대해 백테스트를 실행하기 위해 시작일과 종료일을 지정하는 옵션도 있습니다.
# Poetry 사용 시:
poetry run python src/backtester.py --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01
# Docker 사용 시 (Linux/Mac):
./run.sh --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 backtest
# Docker 사용 시 (Windows):
run.bat --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 backtest
AI 헤지펀드 기능 탐색하기
**AI 헤지펀드**는 단순한 스크립트 이상입니다. 학습 놀이터입니다. 더 깊이 파고드는 방법은 다음과 같습니다.
- 에이전트 사용자 정의:
src/agents/
에서 에이전트 스크립트를 편집합니다 (예: 행동주의 투자용bill_ackman.py
). 저평가 주식 매수와 같은 전략을 조정합니다. - 주식 추가:
--ticker
플래그에 NVDA 또는 TSLA를 시도해 보세요 (무료가 아닌 주식에는 Financial Datasets API 키가 필요합니다). - 백테스팅:
backtester.py
도구는 과거 성과를 시뮬레이션합니다. 과거 수익률을 보려면poetry run python src/backtester.py --ticker AAPL
을 실행하세요. - 센티멘트 분석: 센티멘트 에이전트는 NLP를 사용하여 뉴스 및 소셜 미디어를 분석하여 의사 결정 정확도를 높입니다. 다음으로 테스트해 보세요: "NVDA 뉴스 센티멘트 분석."
- 로컬 실행: Ollama와
llama3
를 사용하여 오프라인 거래 시뮬레이션을 실행하고 API 비용을 절감하세요.
저는 기술 분석 에이전트를 RSI(상대 강도 지수)에 집중하도록 조정했는데, 더 명확한 매수 신호를 보았습니다. 실험하는 것이 정말 재미있었습니다!
APIdog로 API 문서 작성하기
**AI 헤지펀드**를 기반으로 확장하고 다른 사람들을 위해 API 문서를 작성하고 싶으신가요? APIdog는 인터랙티브한 API 문서를 생성하는 데 탁월한 도구입니다. 깔끔한 디자인과 자체 호스팅 옵션으로 거래 시스템의 엔드포인트를 공유하는 데 완벽합니다. 사용해 보세요!

문제 해결 및 팁
- API 키 오류:
.env
파일의 키가 OpenAI/Financial Datasets 계정과 일치하는지 확인하세요.cat .env
로 확인합니다. - 종속성 문제:
poetry install
이 실패하면 Poetry를 업데이트하세요:poetry self update
. - Ollama 연결 안됨:
ollama serve
가 실행 중이고 포트 11434가 열려 있는지 확인하세요 (Linux에서netstat -tulpn | grep 11434
). - 성능: 더 빠르게 실행하려면 Ollama와 함께 GPU를 사용하거나 GPT-4o와 같은 클라우드 LLM을 사용하세요.
- 커뮤니티: 도움을 받거나 사용자 정의 에이전트를 공유하려면 프로젝트의 GitHub 토론에 참여하세요.
AI 헤지펀드를 사용하는 이유
이 **AI 헤지펀드** 프로젝트는 학습을 위한 보물창고입니다:
- 교육적: Two Sigma와 같은 회사에서 AI가 거래를 어떻게 주도하는지 이해할 수 있습니다.
- 위험 없음: 돈을 잃을 위험 없이 거래를 시뮬레이션합니다.
- 사용자 정의 가능: 투자 스타일에 맞게 에이전트를 조정할 수 있습니다.
- 최첨단: 실제 헤지펀드 기술을 반영하여 LLM과 NLP를 사용합니다.
당신이 미친 과학자가 되는 금융 실험실과 같습니다. 센티멘트 에이전트가 MSFT에 대한 낙관적인 뉴스를 포착하고 거래를 조정하는 것을 보는 것이 정말 좋았습니다!
최종 생각: AI 거래 전문가 되기
축하합니다! 자신만의 **AI 헤지펀드**를 시작하고 월스트리트 마법사처럼 거래를 시뮬레이션했습니다! AI 에이전트를 설정하는 것부터 AAPL 및 MSFT에 대한 거래를 실행하는 것까지, 이제 당신은 AI 투자 혁명의 일부입니다. 새로운 주식으로 실험하거나, 에이전트를 조정하거나, APIdog로 API 문서를 작성해 보세요. X 또는 GitHub에 **AI 헤지펀드** 조정 내용을 공유해 주세요. 당신의 거래 제국이 성장하는 것을 보는 것이 기대됩니다! 즐거운 시뮬레이션 되세요!