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 Хедж-фонд

Это концептуальное доказательство работы хедж-фонда на основе искусственного интеллекта. Цель проекта — исследовать использование ИИ для принятия торговых решений. Проект предназначен исключительно для образовательных целей и не предназначен для реальной торговли или инвестирования.

В системе задействовано несколько агентов, работающих совместно:

  1. Агент Aswath Damodaran — Декан оценки, фокусируется на истории, цифрах и дисциплинированной оценке
  2. Агент Ben Graham — Крестный отец стоимостного инвестирования, покупает только скрытые жемчужины с запасом прочности
  3. Агент Bill Ackman — Активный инвестор, занимает смелые позиции и добивается изменений
  4. Агент Cathie Wood — Королева роста, верит в силу инноваций и разрушения рынков
  5. Агент Charlie Munger — Партнер Уоррена Баффета, покупает только выдающиеся бизнесы по справедливым ценам
  6. Агент Michael Burry — Контрарианский инвестор из "Большого шорта", ищет глубокую стоимость
  7. Агент Peter Lynch — Практичный инвестор, ищущий "десятикратников" в обычных бизнесах
  8. Агент Phil Fisher — Тщательный инвестор в рост, использующий глубокие исследования "scuttlebutt"
  9. Агент Rakesh Jhunjhunwala — Большой бык Индии
  10. Агент Stanley Druckenmiller — Макро-легенда, ищущая асимметричные возможности с потенциалом роста
  11. Агент Warren Buffett — Оракул из Омахи, ищет выдающиеся компании по справедливой цене
  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-ключа.

Для любых других тикеров необходимо указать FINANCIAL_DATASETS_API_KEY в файле .env.

Использование

Запуск хедж-фонда

С использованием 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

Вы также можете использовать флаг --ollama для запуска AI хедж-фонда с локальными LLM.

# 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

Флаг --ollama позволяет запустить бэктестер с локальными LLM.

# 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. Создайте Pull Request

Важно: Пожалуйста, делайте ваши Pull Request небольшими и сфокусированными. Это упростит их проверку и слияние.

Запросы функций

Если у вас есть запрос на новую функцию, откройте issue с пометкой enhancement.

Лицензия

Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.