Readme i18n

virattt/ai-hedge-fund

Share
English(original)DeutschEspañolfrançais日本語한국어PortuguêsРусский中文
Last translated: 12 Jun 2025

Translation Not Available Yet

This repository's README hasn't been translated yet. Once translated, it will be easier to read and understand in your native language (中文).

After translating, add the links to README so others can view it directly.

AI 헤지 펀드

이 프로젝트는 AI 기반 헤지 펀드의 개념 증명(proof of concept)입니다. 이 프로젝트의 목표는 AI를 활용한 트레이딩 의사 결정을 탐구하는 것입니다. 이 프로젝트는 교육용으로만 제작되었으며, 실제 트레이딩이나 투자를 목적으로 하지 않습니다.

이 시스템은 여러 에이전트들이 협력하여 작동합니다:

  1. 아스와스 다모다란 에이전트 - 가치 평가의 대가, 스토리, 숫자, 체계적인 가치 평가에 집중
  2. 벤 그레이엄 에이전트 - 가치 투자의 아버지, 안전 마진이 있는 숨은 보석만 매수
  3. 빌 애크만 에이전트 - 액티비스트 투자자, 과감한 포지션과 변화 추진
  4. 캐시 우드 에이전트 - 성장 투자의 여왕, 혁신과 파괴의 힘을 믿음
  5. 찰리 멍거 에이전트 - 워렌 버핏의 파트너, 공정한 가격의 훌륭한 기업만 매수
  6. 마이클 버리 에이전트 - 빅 쇼트의 반대 투자자, 깊은 가치를 추구
  7. 피터 린치 에이전트 - 실용적인 투자자, 일상적인 기업에서 "10배 주식"을 찾음
  8. 필 피셔 에이전트 - 꼼꼼한 성장 투자자, 심층적인 "스커틀버트" 연구 활용
  9. 라케쉬 준준왈라 에이전트 - 인도의 빅 불(Big Bull)
  10. 스탠리 드루켄밀러 에이전트 - 성장 잠재력이 있는 비대칭 기회를 찾는 매크로 전설
  11. 워렌 버핏 에이전트 - 오마하의 현인, 공정한 가격의 훌륭한 기업을 찾음
  12. 가치 평가 에이전트 - 주식의 내재 가치 계산 및 트레이딩 신호 생성
  13. 시장 심리 에이전트 - 시장 심리 분석 및 트레이딩 신호 생성
  14. 기초 분석 에이전트 - 기초 데이터 분석 및 트레이딩 신호 생성
  15. 기술 분석 에이전트 - 기술 지표 분석 및 트레이딩 신호 생성
  16. 리스크 관리자 - 리스크 지표 계산 및 포지션 한도 설정
  17. 포트폴리오 매니저 - 최종 트레이딩 결정 및 주문 생성
Screenshot 2025-03-22 at 6 19 07 PM

참고: 이 시스템은 트레이딩 결정을 시뮬레이션할 뿐, 실제로 거래하지 않습니다.

Twitter Follow

면책 조항

이 프로젝트는 교육 및 연구 목적으로만 제공됩니다.

  • 실제 트레이딩이나 투자를 위한 것이 아님
  • 투자 조언이나 보장을 제공하지 않음
  • 제작자는 금융 손실에 대한 책임을 지지 않음
  • 투자 결정 시 재무 고문과 상담할 것
  • 과거 실적이 미래 결과를 보장하지 않음

이 소프트웨어를 사용함으로써, 귀하는 학습 목적으로만 사용하는 데 동의하는 것입니다.

목차

설정

Poetry 사용

저장소 복제:

git clone https://github.com/virattt/ai-hedge-fund.git
cd ai-hedge-fund
  1. Poetry 설치(아직 설치되지 않은 경우):
curl -sSL https://install.python-poetry.org | python3 -
  1. 종속성 설치:
poetry install
  1. 환경 변수 설정:
# Create .env file for your API keys
cp .env.example .env
  1. API 키 설정:
# For running LLMs hosted by openai (gpt-4o, gpt-4o-mini, etc.)
# Get your OpenAI API key from https://platform.openai.com/
OPENAI_API_KEY=your-openai-api-key

# For running LLMs hosted by groq (deepseek, llama3, etc.)
# Get your Groq API key from https://groq.com/
GROQ_API_KEY=your-groq-api-key

# For getting financial data to power the hedge fund
# Get your Financial Datasets API key from https://financialdatasets.ai/
FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key

Docker 사용

  1. 시스템에 Docker가 설치되어 있는지 확인하세요. 설치되지 않은 경우 Docker 공식 웹사이트에서 다운로드할 수 있습니다.

  2. 저장소 복제:

git clone https://github.com/virattt/ai-hedge-fund.git
cd ai-hedge-fund
  1. 환경 변수 설정:
# Create .env file for your API keys
cp .env.example .env

  1. 위에서 설명한 대로 API 키를 추가하기 위해 .env 파일을 편집하세요.

  2. docker 디렉토리로 이동:

cd docker
  1. Docker 이미지 빌드:
# On Linux/Mac:
./run.sh build

# On Windows:
run.bat build

중요: 헤지 펀드가 작동하려면 OPENAI_API_KEY, GROQ_API_KEY, ANTHROPIC_API_KEY 또는 DEEPSEEK_API_KEY를 설정해야 합니다. 모든 제공업체의 LLM을 사용하려면 모든 API 키를 설정해야 합니다.

AAPL, GOOGL, MSFT, NVDA 및 TSLA의 금융 데이터는 무료이며 API 키가 필요하지 않습니다.

다른 티커의 경우 .env 파일에 FINANCIAL_DATASETS_API_KEY를 설정해야 합니다.

사용법

헤지 펀드 실행

Poetry 사용

poetry run python src/main.py --ticker AAPL,MSFT,NVDA

Docker 사용

참고: 모든 Docker 명령은 docker/ 디렉토리에서 실행해야 합니다.

# Navigate to the docker directory first
cd docker

# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA main

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA main

예제 출력: Screenshot 2025-01-06 at 5 50 17 PM

로컬 LLM을 사용하여 AI 헤지 펀드를 실행하려면 --ollama 플래그를 지정할 수도 있습니다.

# With Poetry:
poetry run python src/main.py --ticker AAPL,MSFT,NVDA --ollama

# With Docker (from docker/ directory):
# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA --ollama main

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA --ollama main

각 에이전트의 추론 과정을 콘솔에 출력하려면 --show-reasoning 플래그를 지정할 수도 있습니다.

# With Poetry:
poetry run python src/main.py --ticker AAPL,MSFT,NVDA --show-reasoning

# With Docker (from docker/ directory):
# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA --show-reasoning main

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA --show-reasoning main

특정 기간에 대한 결정을 내리기 위해 시작 날짜와 종료 날짜를 선택적으로 지정할 수 있습니다.

# With Poetry:
poetry run python src/main.py --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 

# With Docker (from docker/ directory):
# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 main

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 main

백테스터 실행

Poetry 사용

poetry run python src/backtester.py --ticker AAPL,MSFT,NVDA

Docker 사용

참고: 모든 Docker 명령은 docker/ 디렉토리에서 실행해야 합니다.

# Navigate to the docker directory first
cd docker

# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA backtest

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA backtest

예제 출력: Screenshot 2025-01-06 at 5 47 52 PM

특정 기간 동안 백테스트를 실행하기 위해 시작 날짜와 종료 날짜를 선택적으로 지정할 수 있습니다.

# With Poetry:
poetry run python src/backtester.py --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01

# With Docker (from docker/ directory):
# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 backtest

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 backtest

로컬 LLM을 사용하여 백테스터를 실행하려면 --ollama 플래그를 지정할 수도 있습니다.

# With Poetry:
poetry run python src/backtester.py --ticker AAPL,MSFT,NVDA --ollama

# With Docker (from docker/ directory):
# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA --ollama backtest

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA --ollama backtest

기여

  1. 저장소 포크
  2. 기능 브랜치 생성
  3. 변경 사항 커밋
  4. 브랜치에 푸시
  5. 풀 리퀘스트 생성

중요: 풀 리퀘스트는 작고 집중적으로 유지해 주세요. 이렇게 하면 검토와 병합이 쉬워집니다.

기능 요청

기능 요청이 있는 경우 이슈를 열고 enhancement 태그를 달아주세요.

라이선스

이 프로젝트는 MIT 라이선스 하에 제공됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.