MiroFish genera miles de agentes IA con personalidades y memoria propias, los suelta a interactuar entre ellos y predice cómo va a reaccionar el mercado a tu lanzamiento, tu precio o tu campaña. Simulación masiva con IA para ensayar la respuesta del mercado antes de soltar un euro. Más de 73.000 estrellas en GitHub, licencia AGPL-3.0 y una demo en vivo: la pregunta no es si existe, es si funciona de verdad.
TL;DR: El resumen sin rodeos
- Qué es: motor de código abierto de inteligencia de enjambre que simula miles de agentes IA para predecir reacciones del mercado a un lanzamiento, un precio o una campaña.
- Tracción: 73.593 estrellas en GitHub, respaldado por Shanda Group, motor construido sobre OASIS de CAMEL-AI.
- Coste real: la herramienta es gratuita (AGPL-3.0), pero cada simulación quema tokens de la API del LLM que configures.
- La pega gorda: los agentes son prompts de LLM sin verificación de evidencia. Pueden fabricar respuestas convincentes sin base real.
En este artículo
| Qué es | Motor open source de inteligencia de enjambre que simula miles de agentes IA para predecir el desenlace de escenarios sociales, de mercado o políticos. |
|---|---|
| Web oficial | https://mirofish.ai/ |
| Repositorio | repo |
| Licencia | AGPL-3.0 |
| Precio | freemium |
| Alternativa a | forecasting manual con hojas de cálculo y focus groups |
| Estrellas en GitHub | 73.593 |
| Año de lanzamiento | 2025 |
| Quién lo mantiene | 666ghj (persona) |
Revisado el 2026-09-15
Esta herramienta forma parte del recopilatorio vivo Skills para Claude Code, Codex y otros agentes de código →
El problema que resuelve
MiroFish ataca un hueco que cualquier equipo de marketing conoce: no existe un ensayo general barato para el mercado. Testar una campaña o un lanzamiento con personas reales significa un grupo focal que cuesta miles de euros y tarda semanas, una encuesta con sesgos de autoselección evidentes o, seamos honestos, lanzar y cruzar los dedos.
La propuesta es directa: le das el material (un post de lanzamiento, un nuevo precio, un anuncio), le dices qué quieres saber y MiroFish genera cientos de personajes IA con perfiles diversos. Los deja reaccionar entre ellos y te devuelve un informe de predicción. Un grupo focal sintético, veinticuatro horas al día, sin moderador y sin pizza.
Por debajo, su motor de simulación corre sobre OASIS (Open Agent Social Interaction Simulations), un proyecto de investigación de CAMEL-AI. No es un proyecto personal con un README bonito: tiene base académica y respaldo corporativo de Shanda Group.
Cómo se pone en marcha
MiroFish se despliega desde código fuente (Node.js + Python) o con Docker, y necesita dos claves de API externas para funcionar.
Para la ruta desde código: clonas el repositorio, copias .env.example a .env y rellenas dos claves obligatorias. La primera, una API de LLM compatible con el formato OpenAI SDK (el proyecto recomienda Qwen-plus de Alibaba a través de Bailian). La segunda, una cuenta de Zep Cloud para la memoria de los agentes, que ofrece cuota gratuita mensual para uso básico. Requisitos: Node.js 18+, Python entre 3.11 y 3.12, y el gestor de paquetes uv.
Después: npm run setup:all instala todo y npm run dev levanta los servicios. Frontend en localhost:3000, API en localhost:5001. Con Docker se reduce a copiar el .env y docker compose up -d. Si no quieres instalar nada todavía, hay una demo interactiva para experimentar con un escenario prediseñado.
Copia esto y pégalo en Claude Code, Cursor o tu asistente de código favorito:
Clona https://github.com/666ghj/mirofish, configura el .env con mi clave de API de LLM y una cuenta gratuita de Zep Cloud, instala dependencias con npm run setup:all y lanza una simulación de prueba con 20 agentes que reaccionen a este texto de lanzamiento: [pega aquí tu texto].
No necesitas saber programar. El asistente se encarga de la instalación, la configuración y las pruebas.
Usándola en marketing real
¿Y esto para qué sirve si trabajas en agencia o como freelance? El escenario típico: un cliente quiere "validar el mensaje antes de invertir en paid media". Traducción: tres semanas de encuestas, un estudio de mercado externo o tu intuición disfrazada de estrategia.
Con MiroFish podrías alimentar la simulación con el borrador de la página de destino, el precio propuesto y el texto del anuncio. Generar 500 agentes con perfiles variados y ver qué sale. Ya hablamos de agentes IA aplicados al marketing: lo de MiroFish va un paso más allá, porque simula un comportamiento social completo.
Mi lectura: lo útil no es creerte la simulación al pie de la letra. Son los ángulos que no habías visto. Si 300 de tus 500 agentes reaccionan mal al precio pero no al producto, eso es una señal. No una verdad: una señal. El que confunda ambas cosas tiene un problema mayor que el de elegir herramienta.
Lo que no te cuentan
Los agentes de MiroFish son prompts de LLM, no personas simuladas con cognición real. La "opinión" de cada personaje es lo que un modelo de lenguaje predice que diría alguien con ese perfil. Esos perfiles no han vivido nada. Lo que te devuelven es un modelo de lenguaje prediciendo qué palabras van después de otras. SOLO eso. Y eso tiene un techo. Conócelo antes de tomar decisiones con lo que te devuelva.
El coste: MiroFish es gratuito, pero cada simulación consume tokens de la API que configures. Una simulación larga con cientos de agentes puede disparar la factura. El propio README recomienda empezar con menos de 40 rondas.
La instalación no es trivial. Dos claves de API, un entorno Python específico (3.11-3.12, no vale otra versión), Node.js y uv. Para un perfil de marketing sin equipo técnico, esta barrera no es menor.
Y la licencia. AGPL-3.0 obliga a publicar con la misma licencia cualquier modificación que distribuyas. Si una agencia quiere integrar MiroFish en un producto propio, revisa las implicaciones legales antes de montar nada.
Qué dice la gente
En r/MiroFish, un usuario abre el debate preguntando cuál es la barrera real para usar la herramienta y pone sobre la mesa las sospechosas: complejidad de la configuración, huecos en la documentación, diseño de prompts y no saber si lo que sale tiene calidad real. El camino entre "la instalo" y "me da algo útil" es más largo de lo que el README sugiere.
"For most people I assume it is one of these: setup complexity cost unclear use cases documentation gaps prompt design not knowing how to evaluate output quality What is the real blocker for you right now? Would be useful to see whether the biggest problem is technical, conceptual" srch4aheartofgold en reddit
"TL;DR: MiroFish spawns AI agents to predict things. Cool idea, but the agents hallucinate and they make up plausible justifications with zero evidence checking. I built Brain in the Fish , a Rust MCP server that fixes this with a Spiking Neural Network verification layer that mak" Successful-Farm5339 en reddit
"TL;DR: MiroFish spawns AI agents to predict things. Cool idea, but the agents hallucinate and they make up plausible justifications with zero evidence checking. I built Brain in the Fish , a Rust MCP server that fixes this with a Spiking Neural Network verification layer that mak" Successful-Farm5339 en reddit
En r/SideProject, un desarrollador construyó un proyecto entero ("Brain in the Fish") para resolver lo que considera el problema fundamental de MiroFish: que los agentes "fabrican justificaciones plausibles sin verificación de evidencia". Que alguien monte una herramienta entera para parchear el agujero central de otra ya te dice todo sobre lo gordo de esa limitación.
Alternativas
MiroFish compite con lo de toda la vida: grupos focales presenciales, encuestas cuantitativas y hojas de cálculo con modelos de previsión. La simulación con IA gana en velocidad y coste. Lo otro gana en algo que no se puede fabricar: personas reales con opiniones reales.
A día de hoy no hay nada de código abierto con la misma tracción. Si buscas validación de verdad, las encuestas online siguen siendo lo más fiable y accesible. MiroFish no las reemplaza: las precede como primer filtro barato.
Veredicto
La idea de MiroFish tiene sentido. La ejecución todavía cojea. La promesa de simular miles de clientes antes de lanzar suena de maravilla, pero lo que estás simulando es lo que un LLM cree que esos clientes pensarían. No es lo mismo.
¿Merece la pena probarlo? Si tienes el perfil técnico para montarlo y la disciplina de no confundir una simulación con una validación, sí. Tiene todo el sentido como primer filtro barato antes de soltar la pasta gorda. Pero que nadie confunda esto con hablar con personas reales, porque no se le acerca.
