# Instrucciones para el agente: AI Hedge Fund: estudia decisiones financieras multiagente

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: avanzado
- Proyecto: https://github.com/virattt/ai-hedge-fund (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/ai-hedge-fund-educational

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba que pipx está disponible y que el entorno que usará para aihf tiene Python ≥3.11,<4.0; ese intervalo corresponde a `python = "^3.11"` en [pyproject.toml](https://github.com/virattt/ai-hedge-fund/blob/main/pyproject.toml).

La CLI documentada se instala y abre así:

```sh
pipx install aihf
aihf
```

El primer uso pide una clave de Financial Datasets y otra del proveedor de modelos seleccionado; las guarda en `~/.hedge-fund/.env`, según el [README](https://github.com/virattt/ai-hedge-fund#api-keys). Entrégalas solo en la interfaz privada. Elige Backtesting en la aplicación, un universo pequeño y un periodo histórico con datos disponibles. Los resultados de esa ruta se guardan en `~/.hedge-fund/research/`; comprueba el archivo y las fechas de la simulación antes de ampliar la prueba. Mantén el ejercicio en el alcance educativo que declara el proyecto.

## Comprobación

Revisa las fuentes, fechas y supuestos de cada análisis. Comprueba que la salida no se interprete como una orden ejecutada ni como evidencia de rentabilidad.

## Si algo falla

Si falta información, revisa primero la fuente de datos. Si falla un agente, comprueba su proveedor de modelos y conserva la limitación en el resultado.

Consulta [el README oficial](https://github.com/virattt/ai-hedge-fund#readme) para requisitos y variantes de instalación.