Infraestructura en Python que convierte datos empresariales en una capa de contexto basada en grafos, con ontologías, razonamiento, procedencia y registros de auditoría de decisiones para sistemas de IA.
666ghj/MiroFish
Un motor de simulación de enjambres multiagente que crea un mundo digital a partir de material semilla para predecir los resultados de eventos informativos, políticos o financieros.
- Estrellas
- 80,574
- Forks
- 12,228
- Issues abiertos
- 156
- Último commit
- hace 4 días
¿Qué es?
MiroFish es un motor de predicción que usa simulación multiagente. Se carga material semilla, como artículos periodísticos, borradores de políticas, señales financieras o incluso una novela, y se describe en lenguaje natural qué se quiere predecir. El sistema extrae entidades y relaciones para crear un grafo de conocimiento, genera agentes con personalidades y memoria propias, y ejecuta una simulación en dos plataformas en la que interactúan durante muchas rondas.
Durante una ejecución, los usuarios pueden introducir nuevas variables en el entorno simulado para probar cómo cambian la trayectoria distintas condiciones. Cuando termina la simulación, un ReportAgent genera un informe de predicción y permite conversar con agentes individuales o con el agente del informe para explorar los resultados.
El backend está desarrollado en Python y el frontend se ejecuta en Node.js. Se basa en el framework de simulación social de agentes OASIS de CAMEL-AI y usa Zep Cloud para la memoria. Admite cualquier API de LLM compatible con OpenAI para las llamadas al modelo. También se ofrece la implementación con Docker Compose.
Funciones clave
- 01Crea un grafo de conocimiento y perfiles de agentes a partir del material semilla cargado.
- 02Ejecuta simulaciones de varias rondas en las que agentes con memoria interactúan en dos plataformas.
- 03Permite introducir variables en una simulación en curso para probar distintos escenarios.
- 04Genera un informe de predicción mediante un ReportAgent con el que se puede interactuar mediante consultas.
- 05Permite conversar directamente con agentes simulados individuales.
- 06Admite cualquier API de LLM compatible con OpenAI y ofrece implementación desde el código fuente o con Docker.
Casos de uso
- Ensayar cómo podría evolucionar la opinión pública en torno a una noticia o política antes de publicarla.
- Explorar finales alternativos o distintos escenarios para una novela o historia.
- Ejecutar simulaciones hipotéticas con señales financieras o de mercado.
- Estudiar cómo las interacciones entre agentes individuales producen resultados colectivos en sistemas sociales.
Inicio rápido
- 1
Copia el archivo de entorno de ejemplo
cp .env.example .env - 2
Añade las claves API necesarias (LLM y Zep) a .env
- 3
Instala todas las dependencias
npm run setup:all - 4
Inicia el frontend y el backend (frontend en localhost:3000 y backend en localhost:5001)
npm run dev
Antes de usarlo
- Se necesita una clave API de LLM y una clave API de Zep Cloud; además, las simulaciones pueden consumir muchos tokens.
- Para desplegar desde el código fuente, se requiere Python 3.11 a 3.12, Node.js 18 o superior y el gestor de paquetes uv.
- La licencia AGPL-3.0 exige compartir el código fuente de las versiones modificadas que se ofrezcan a través de una red.
Temas
Preguntas frecuentes
- ¿Qué es MiroFish?
- Un motor de simulación de enjambres multiagente que crea un mundo digital a partir de material semilla para predecir los resultados de eventos informativos, políticos o financieros. MiroFish es un motor de predicción que usa simulación multiagente. Se carga material semilla, como artículos periodísticos, borradores de políticas, señales financieras o incluso una novela, y se describe en lenguaje natural qué se quiere predecir. El sistema extrae entidades y relaciones para crear un grafo de conocimiento, genera agentes con personalidades y memoria propias, y ejecuta una simulación en dos plataformas en la que interactúan durante muchas rondas.
- ¿MiroFish es gratuito? ¿Qué licencia tiene?
- MiroFish es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿MiroFish sigue mantenido?
- Mantenimiento activo. El último commit de MiroFish fue el 16 oct 2026.
- ¿Para qué puedo usar MiroFish?
- Ensayar cómo podría evolucionar la opinión pública en torno a una noticia o política antes de publicarla. Explorar finales alternativos o distintos escenarios para una novela o historia. Ejecutar simulaciones hipotéticas con señales financieras o de mercado. Estudiar cómo las interacciones entre agentes individuales producen resultados colectivos en sistemas sociales.
- ¿Cómo se instala MiroFish?
- Copia el archivo de entorno de ejemplo: cp .env.example .env Añade las claves API necesarias (LLM y Zep) a .env Instala todas las dependencias: npm run setup:all Inicia el frontend y el backend (frontend en localhost:3000 y backend en localhost:5001): npm run dev
- ¿Dónde consigo MiroFish?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/666ghj/MiroFish
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Una biblioteca de Python que restringe las salidas de los LLM durante la generación para que coincidan con un tipo, una expresión regular, un esquema JSON o una gramática determinados.
Base de conocimiento autohospedada en Rust que crea un grafo de conocimiento bitemporal a partir de documentos, con búsqueda RAG, razonamiento basado en ontologías y acceso MCP para agentes.
Convierte texto no estructurado en un grafo de conocimiento interactivo usando un LLM para extraer tripletas sujeto-predicado-objeto.
Herramienta de grafos de conocimiento local que usa Ollama para que un modelo ejecutado en tu máquina razone paso a paso y almacene el razonamiento como un grafo RDF.
Repositorio educativo con 30 notebooks de Jupyter ejecutables sobre técnicas de memoria para agentes LLM, desde buffers de conversación hasta Mem0, Letta, Zep y Graphiti.