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を活用したヘッジファンドのコンセプト実証です。このプロジェクトの目的は、AIを用いて取引判断を行う手法を探求することです。本プロジェクトは教育目的のみを対象としており、実際の取引や投資を意図したものではありません。

このシステムは複数のエージェントが協働する仕組みを採用しています：

  1. アスワス・ダモダラン・エージェント - 企業評価の権威。ストーリー、数値、規律ある評価に焦点
  2. ベン・グレアム・エージェント - バリュー投資の父。安全域のある隠れた宝石のみを購入
  3. ビル・アックマン・エージェント - アクティビスト投資家。大胆なポジションを取り変革を推進
  4. キャシー・ウッド・エージェント - 成長株投資の女王。イノベーションと破壊的変化の力を信じる
  5. チャーリー・マンガー・エージェント - ウォーレン・バフェットのパートナー。適正価格の素晴らしい企業のみを購入
  6. マイケル・バリー・エージェント - 「ビッグ・ショート」で知られる逆張り投資家。深いバリューを追求
  7. ピーター・リンチ・エージェント - 日常のビジネスから「10倍株」を探す実践的投資家
  8. フィル・フィッシャー・エージェント - 徹底的な「噂調査」を行う成長株投資家
  9. ラケシュ・ジュンフンワラ・エージェント - インドの「ビッグ・ブル」
  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. 前述の通り.envファイルを編集してAPIキーを追加

  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. プルリクエストを作成

重要: プルリクエストは小さく焦点を絞ったものにしてください。これによりレビューとマージが容易になります。

機能リクエスト

機能リクエストがある場合は、issueを開き、enhancementタグを付けてください。

ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。