Cómo instalar MiroFish en Windows paso a paso: guía completa desde cero
La inteligencia artificial ya no se limita a responder preguntas. Una de las áreas más interesantes que están surgiendo es la simulación mediante agentes de IA: sistemas capaces de crear personajes con intereses diferentes, hacerlos interactuar dentro de un escenario y observar cómo podría evolucionar una situación.
Por esa razón decidí probar MiroFish.
En lugar de comenzar con un escenario complejo, realicé primero un experimento sencillo: una ciudad ficticia anuncia que una de sus principales calles será cerrada al tránsito vehicular los domingos para convertirla temporalmente en una zona peatonal.
A partir de esa pequeña “semilla de realidad”, MiroFish identificó distintos actores: residentes, comerciantes, restaurantes, conductores de transporte público, autoridades municipales y organizaciones ambientalistas.
Luego creó agentes, relaciones entre ellos y un entorno donde podían reaccionar ante la nueva medida.
El resultado fue particularmente interesante.
No todos los comerciantes reaccionaron igual. Algunos restaurantes esperaban recibir más clientes debido al aumento de peatones, mientras otros negocios temían perder a quienes normalmente llegan en automóvil.
Los residentes, por su parte, no necesariamente rechazaban la zona peatonal, pero comenzaron a preocuparse por el posible desvío del tráfico hacia sus barrios.
Los conductores de transporte público veían una oportunidad para aumentar el número de pasajeros, mientras las organizaciones ambientales defendían la medida por sus posibles beneficios para la contaminación y la calidad del espacio urbano.
La simulación comenzó así a desarrollar diferentes intereses y posiciones sin que nosotros tuviéramos que indicarle de antemano quién debía apoyar o rechazar la medida.
¿Qué hace realmente MiroFish?
Una manera sencilla de entenderlo es esta:
MiroFish dirige la simulación.
El modelo de inteligencia artificial —en mi instalación utilicé Qwen— funciona como el cerebro que permite razonar y responder a los distintos agentes.
Zep, por otro lado, funciona como una capa de memoria. Allí pueden almacenarse acontecimientos, relaciones y contexto para que los agentes no reaccionen siempre como si fuera la primera vez que ocurre algo.
Podemos representarlo de esta manera:
Documentos y escenario inicial ↓ MiroFish ↓ crea actores y relaciones ↓ Agentes de IA ↓ Qwen razona ↓ Zep recuerda ↓ interacciones y eventos ↓ Informe de resultados
Esto permite construir pequeños mundos simulados donde diferentes actores toman posiciones, reaccionan a otros agentes y generan nuevos acontecimientos.
Sin embargo, es importante comprender que estamos hablando de simulación generativa, no de una máquina capaz de conocer con certeza el futuro.
Los resultados deben interpretarse como escenarios posibles que pueden servir para explorar comportamientos, conflictos, alianzas y consecuencias.
Instalar MiroFish no es como instalar un programa tradicional
Aquí encontré una de las principales dificultades.
MiroFish no se instala simplemente descargando un archivo setup.exe.
Es un proyecto moderno compuesto por diferentes tecnologías que trabajan juntas.
En Windows necesitamos preparar varias herramientas:
GitNode.jsnpmPythonuvMiroFishQwenZep
Para alguien acostumbrado a aplicaciones tradicionales esto puede parecer complicado al principio.
Por eso decidí documentar todo el proceso que realicé, desde una computadora que todavía no tenía todas las herramientas necesarias hasta conseguir ejecutar una simulación completa y generar el informe final.
Preparé un manual de instalación desde cero
El manual está pensado especialmente para quienes no quieren limitarse a copiar comandos sin saber dónde ejecutarlos o qué están haciendo.
La guía comienza explicando cómo abrir PowerShell en Windows y cómo comprobar una por una las herramientas que necesita MiroFish.
Por ejemplo:
git --versionnode -vnpm -vpython --versionuv --version
Si alguna herramienta no está instalada, el manual explica cómo obtenerla y cómo verificar posteriormente que Windows la reconoce correctamente.
También documenté un caso que encontramos durante la instalación: mi computadora ya tenía Python 3.14, pero MiroFish necesitaba una versión compatible.
En lugar de eliminar Python 3.14, instalamos Python 3.12 en paralelo, administrado mediante uv, exclusivamente para MiroFish.
De esa forma ambas versiones pueden coexistir sin afectar otros programas.
¿Qué incluye el manual?
La guía documenta prácticamente todo el recorrido que realicé:
- verificación inicial de Windows;
- cómo abrir y utilizar PowerShell;
- instalación de Git;
- instalación de Node.js y npm;
- instalación de
uv; - instalación de Python 3.12;
- descarga del proyecto oficial mediante Git;
- instalación de las dependencias;
- explicación de los entornos virtuales de Python;
- configuración del archivo
.env; - creación y configuración de Zep;
- creación de la API para Qwen;
- configuración de Alibaba Cloud Model Studio;
- protección del consumo mediante Stop-on-Exhaust;
- configuración del endpoint correcto;
- inicio de MiroFish;
- acceso mediante
localhost; - creación de una simulación de prueba;
- selección de rondas;
- creación del grafo de actores;
- ejecución de la simulación;
- generación del informe;
- ubicación del informe completo en Windows;
- diagnóstico de errores;
- recuperación de una simulación que aparentemente quedó detenida;
- comandos necesarios para iniciar nuevamente MiroFish en otro momento.
También incorporé capturas reales de pantalla tomadas mientras realizaba la instalación.
No se trata, por tanto, de una guía escrita únicamente a partir de documentación teórica. Es el procedimiento que utilicé realmente hasta conseguir que MiroFish funcionara.
También documenté los problemas
Algo que considero importante en cualquier manual técnico es no mostrar únicamente el camino perfecto.
Durante nuestra primera prueba apareció, por ejemplo, este error:
HTTP 401
MiroFish no podía autenticarse correctamente con el proveedor del modelo de IA.
La solución terminó estando relacionada con el endpoint específico del workspace de Alibaba Cloud.
También encontramos otro comportamiento interesante.
La simulación había terminado, pero MiroFish permanecía aparentemente detenido y el botón para generar el informe no se habilitaba.
Revisando los archivos de registro descubrimos que el motor había terminado correctamente y simplemente había quedado esperando nuevos comandos.
El manual explica también cómo detectar y resolver ese escenario.
Es precisamente ese tipo de situaciones el que suele hacer que una instalación técnica resulte frustrante cuando una guía solo dice:
“Ejecute este comando y continúe”.
¿Qué obtuvimos al final?
Después de configurar correctamente todo el entorno conseguimos completar el ciclo:
Documento inicial ↓Creación del grafo ↓Generación de agentes ↓Simulación ↓Memoria y relaciones ↓Informe final
Nuestra simulación experimental analizó las primeras horas posteriores al anuncio de la zona peatonal ficticia.
El informe encontró algo particularmente interesante: las posiciones no se dividieron simplemente entre quienes estaban “a favor” y “en contra”.
Las respuestas aparecieron principalmente alrededor de los intereses prácticos de cada actor.
Es decir, la simulación comenzó a producir comportamientos emergentes.
Y justamente ahí está, a mi juicio, una de las partes más interesantes de esta tecnología.
Una advertencia necesaria
MiroFish puede construir detalles adicionales para completar el mundo simulado.
Eso significa que durante una simulación pueden aparecer antecedentes, relaciones, características o situaciones que no estaban literalmente presentes en los documentos iniciales.
Por esta razón sus resultados no deben interpretarse como:
“Esto es exactamente lo que sucederá”.
Una formulación mucho más apropiada sería:
“Dadas estas condiciones y estos actores, este es uno de los comportamientos plausibles que puede generar la simulación”.
Eso permite utilizar la herramienta de una manera mucho más responsable.
Puede ayudarnos a explorar preguntas como:
- ¿Quién podría verse afectado?
- ¿Qué intereses entrarían en conflicto?
- ¿Qué alianzas inesperadas podrían aparecer?
- ¿Qué argumentos podrían dominar el debate?
- ¿Qué efectos secundarios no habíamos considerado?
- ¿Qué información adicional deberíamos investigar?
Descarga el manual
He preparado el documento:
Manual de MiroFish para Windows — Instalación, configuración y primera simulación
La guía está diseñada para acompañar al usuario desde una computadora sin configurar hasta conseguir ejecutar MiroFish y producir su primer informe.
👉 [DESCARGAR MANUAL DE MIROFISH]
Video del proceso
También preparé un video mostrando el experimento y parte del funcionamiento de MiroFish.
En él puede observarse cómo el sistema construye el escenario, genera actores, establece relaciones y comienza a desarrollar los acontecimientos dentro del mundo simulado.
👉 [VER VIDEO EN YOUTUBE]
Lo siguiente: simulaciones más complejas
Esta primera prueba tenía un propósito principalmente técnico: comprobar que toda la infraestructura funcionaba correctamente y entender cómo trabaja MiroFish.
Una vez superada esta etapa, es posible comenzar a experimentar con escenarios considerablemente más complejos, proporcionando documentos reales, antecedentes históricos, legislación, grupos sociales y diferentes intereses.
Y ahí comienza la parte verdaderamente interesante:
no decirle a la inteligencia artificial cuál debe ser el resultado, sino construir cuidadosamente las condiciones iniciales y observar qué sucede dentro de la simulación.
Ese será el próximo experimento.