Apidog

Plataforma de desarrollo de API colaborativa todo en uno

Diseño de API

Documentación de API

Depuración de API

Simulación de API

Prueba automatizada de

Fondo de Inversión Libre con IA de Código Abierto: ¡Análisis Completo!

Ashley Goolam

Ashley Goolam

Updated on May 26, 2025

¿Alguna vez te has preguntado cómo la élite de Wall Street utiliza la IA para amasar millones? Con el proyecto AI Hedge Fund, puedes sumergirte en el mundo del trading automatizado sin arriesgar un centavo. Esta joya de código abierto de GitHub te permite simular un fondo de cobertura impulsado por agentes de IA inspirados en leyendas como Warren Buffett y Cathie Wood. Me enganché explorando sus estrategias de trading, y en este tutorial, te mostraré cómo configurar tu propio AI Hedge Fund, ejecutar una simulación de trading con acciones como Apple y Microsoft, y echar un vistazo bajo el capó de sus inteligentes agentes. No se necesita un doctorado en finanzas, ¡solo curiosidad y un portátil! ¿Listo para jugar a ser gestor de fondos de cobertura? ¡Vamos allá!

💡
¿Necesitas documentar tus APIs? Prueba APIdog para una forma elegante e interactiva de crear y compartir documentación de API, ¡perfecto para tus proyectos de trading con IA!
button

¿Qué es el AI Hedge Fund? Tu equipo de trading virtual

El AI Hedge Fund es un proyecto de código abierto en GitHub que simula un fondo de cobertura utilizando agentes de IA para tomar decisiones de trading. Puedes pensar en él como un equipo digital de ensueño donde cada agente tiene una especialidad, imitando a gurús de inversión del mundo real. Diseñado con fines educativos, utiliza grandes modelos de lenguaje (LLMs) como GPT-4o o Llama 3 para analizar datos financieros y simular operaciones; no hay dinero real involucrado. Las características clave incluyen:

  • Agentes especializados: Agentes de Fundamentales, Técnicos, Sentimiento, Gestor de Riesgos y Gestor de Cartera analizan datos y toman decisiones.
  • Fuentes de datos: Extrae datos financieros gratuitos para acciones como AAPL, MSFT, NVDA, GOOGL y TSLA a través de la API de Financial Datasets.
  • Personalizable: Ejecútalo con LLMs basados en la nube (OpenAI, Groq) o modelos locales a través de Ollama.
  • Simulación: Realiza backtests de estrategias para ver cómo se habrían comportado las operaciones.

Con más de 2K estrellas, es un éxito para aprender cómo la IA está revolucionando los fondos de cobertura. ¡Vamos a configurarlo para que opere de forma más inteligente que un operador de Wall Street!

ai hedge fund architecture

Configurando tu entorno para el AI Hedge Fund

Antes de desatar tu AI Hedge Fund, preparemos tu sistema. Esto es apto para principiantes y te guiaré a través de cada paso.

1. Comprueba los requisitos del sistema:

  • SO: Windows (con WSL2), macOS o Linux (Ubuntu 20.04+ recomendado).
  • Software:
  • Python 3.10 (verifica con python3 --version).
  • Git (verifica con git --version).
  • Docker CLI o Docker Desktop para Ollama (opcional, para LLMs locales).
  • Si estás en Windows, instala WSL2 WSL2 ejecutando wsl --install en PowerShell (Admin) y reinicia. ¿Falta algo? Instálalo ahora desde python.org o git-scm.com.

2. Instala Poetry: Poetry gestiona las dependencias de Python. Instálalo:

curl -sSL https://install.python-poetry.org | python3 -

Verifica con poetry --version (por ejemplo, 1.8.0). Añade Poetry a tu PATH si es necesario: export PATH="$HOME/.local/bin:$PATH".

3. Obtén claves de API:

  • OpenAI: Regístrate en platform.openai.com para obtener acceso a GPT-4o. Copia tu clave de API.
  • Financial Datasets: Regístrate en financialdatasets.ai para obtener datos bursátiles gratuitos (AAPL, MSFT, etc.). Copia la clave.
  • Opcional: Claves de Groq (groq.com) o Anthropic (anthropic) para otros LLMs, o Ollama para modelos locales.

4. Crea una carpeta para el proyecto: Mantente organizado:

mkdir ai-hedge-fund
cd ai-hedge-fund

Instalando el AI Hedge Fund

Ahora, clonemos y configuremos el proyecto AI Hedge Fund. Es rápido y te prepara para las simulaciones de trading.

1. Clona el repositorio: Obtén el código de GitHub:

git clone https://github.com/virattt/ai-hedge-fund.git
cd ai-hedge-fund

Esto descarga el proyecto (~50MB), incluyendo scripts de agentes y herramientas.

2. Instala dependencias: Usa Poetry para instalar las librerías necesarias:

poetry install

Esto configura paquetes de Python como pandas, requests y SDKs de LLM. Tarda uno o dos minutos.

3. Configura las claves de API: Crea un archivo .env para almacenar tus claves:

cp .env.example .env

Edita .env con un editor de texto (por ejemplo, nano .env) y añade:

# 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

Guarda y sal. Para LLMs locales, omite OpenAI y usa Ollama (ver abajo).

4. Opcional: Configura Ollama para LLMs locales: ¿Quieres ejecutar modelos como Llama 3 localmente? Instala Ollama:

curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3

Inicia Ollama: ollama serve. Esto usa ~5GB para Llama 3. Asegúrate de que Docker está instalado (docker.com) si lo ejecutas a través de Docker.

ollama

Ejecutando tu AI Hedge Fund: Una simulación de trading

Pongamos en marcha tu AI Hedge Fund y simulemos operaciones con acciones como Apple (AAPL) y Microsoft (MSFT). Veremos cómo trabajan juntos los agentes de IA.

1. Ejecuta la simulación: En la carpeta ai-hedge-fund, ejecuta:

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

O, para LLMs locales:

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

Este comando:

  • Se dirige a AAPL y MSFT (datos gratuitos de Financial Datasets).
  • Utiliza agentes de IA para analizar fundamentales (por ejemplo, ratios P/E), técnicos (por ejemplo, medias móviles), sentimiento (por ejemplo, noticias) y riesgos.
  • Simula operaciones y genera decisiones.

2. ¿Qué sucede?: Los agentes colaboran:

  • Agente de Fundamentales: Comprueba el crecimiento de ingresos de AAPL y el flujo de caja de MSFT.
  • Agente Técnico: Analiza medias móviles de 50 días para señales de compra/venta.
  • Agente de Sentimiento: Escanea noticias en busca de vibraciones positivas/negativas (por ejemplo, "Apple lanza nuevo iPhone").
  • Gestor de Riesgos: Establece límites de posición para evitar grandes pérdidas.
  • Gestor de Cartera: Decide comprar 100 acciones de AAPL y mantener MSFT basándose en las señales.
run tests

Ver resultados: Comprueba la terminal para ver las decisiones de trading, probabilidades y resultados del backtest. Los registros se guardan en src/logs/.

3. Ejecutando el Backtester: usa el siguiente comando:

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

Salida de ejemplo:

backtest

También tienes la opción de especificar las fechas de inicio y fin para realizar el backtest sobre un período de tiempo específico.

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

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

# With Docker (on Windows):
run.bat --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 backtest

Explorando las características del AI Hedge Fund

Tu AI Hedge Fund es más que un script: es un campo de juego para el aprendizaje. Aquí te explicamos cómo profundizar:

  • Personalización de agentes: Edita los scripts de los agentes en src/agents/ (por ejemplo, bill_ackman.py para inversión activista). Ajusta estrategias como la compra de acciones infravaloradas.
  • Añade acciones: Prueba NVDA o TSLA en la bandera --ticker (requiere una clave de API de Financial Datasets para acciones no gratuitas).
  • Backtesting: La herramienta backtester.py simula el rendimiento histórico. Ejecuta poetry run python src/backtester.py --ticker AAPL para ver los rendimientos pasados.
  • Análisis de sentimiento: El Agente de Sentimiento utiliza PNL para analizar noticias y redes sociales, mejorando la precisión de las decisiones. Pruébalo con: "Analyze NVDA news sentiment."
  • Ejecutar localmente: Usa Ollama con llama3 para simulaciones de trading offline, ahorrando costes de API.

Modifiqué el Agente Técnico para centrarse en el RSI (Índice de Fuerza Relativa) y vi señales de compra más claras, ¡súper divertido experimentar!

Documentando tus APIs con APIdog

¿Estás ampliando tu AI Hedge Fund y quieres documentar sus APIs para otros? APIdog es una herramienta de primera categoría para crear documentación de API interactiva. Su diseño elegante y opciones de autoalojamiento lo hacen perfecto para compartir los puntos finales de tu sistema de trading. ¡Pruébalo!

apidog documentation

Resolución de problemas y consejos

  • Errores de clave de API: Asegúrate de que las claves en .env coinciden con tus cuentas de OpenAI/Financial Datasets. Comprueba con cat .env.
  • Problemas de dependencias: Si poetry install falla, actualiza Poetry: poetry self update.
  • Ollama no se conecta: Verifica que ollama serve está ejecutándose y que el puerto 11434 está abierto (netstat -tulpn | grep 11434 en Linux).
  • Rendimiento: Para ejecuciones más rápidas, usa una GPU con Ollama o quédate con LLMs en la nube como GPT-4o.
  • Comunidad: Únete a las discusiones del proyecto en GitHub para obtener ayuda o compartir tus agentes personalizados.

¿Por qué usar un AI Hedge Fund?

Este proyecto AI Hedge Fund es una mina de oro para aprender:

  • Educativo: Entiende cómo la IA impulsa el trading en firmas como Two Sigma.
  • Sin riesgo: Simula operaciones sin perder dinero.
  • Personalizable: Ajusta los agentes para que coincidan con tu estilo de inversión.
  • De vanguardia: Utiliza LLMs y PNL, reflejando la tecnología real de los fondos de cobertura.

Es como un laboratorio de finanzas donde eres el científico loco. ¡Me encantó ver al Agente de Sentimiento captar noticias alcistas sobre MSFT y ajustar las operaciones!

Reflexiones finales: Conviértete en un profesional del trading con IA

¡Enhorabuena! Has lanzado tu propio AI Hedge Fund y simulado operaciones como un mago de Wall Street. Desde configurar agentes de IA hasta ejecutar operaciones con AAPL y MSFT, ahora eres parte de la revolución de la inversión con IA. Experimenta con nuevas acciones, ajusta agentes o documenta tus APIs con APIdog. Comparte tus ajustes del AI Hedge Fund en X o GitHub. ¡Estoy emocionado de ver crecer tu imperio de trading! ¡Feliz simulación!

button