Motor de inteligencia colectiva simple y universal para el mercado hispano
Sube cualquier informe · Predice el futuro al instante

🇪🇸 Español | 🇺🇸 English

⚡ Visión General

MiroFish es un motor de predicción de nueva generación impulsado por tecnología multi-agente. Al extraer información semilla del mundo real (como noticias de última hora, borradores de políticas o señales financieras), construye automáticamente un mundo digital paralelo de alta fidelidad. En este espacio, miles de agentes inteligentes con personalidades independientes, memoria a largo plazo y lógica conductual interactúan libremente y experimentan evolución social. Puedes inyectar variables dinámicamente desde una "visión divina" para deducir con precisión las trayectorias futuras — ensaya el futuro en un sandbox digital y gana decisiones después de innumerables simulaciones.

Solo necesitas: Subir materiales semilla (informes de análisis, noticias, datos de mercado) y describir tus requisitos de predicción en lenguaje natural

MiroFish te devolverá: Un informe de predicción detallado y un mundo digital de alta fidelidad con el que podrás interactuar profundamente

🌎 Nuestra Visión para el Mercado Hispano

MiroFish en español está dedicado a crear un espejo de inteligencia colectiva que mapea la realidad del mercado hispano. Al capturar la emergencia colectiva desencadenada por interacciones individuales, rompemos las limitaciones de la predicción tradicional:

• A nivel macro: Somos el laboratorio de ensayo para agencias, empresas y profesionales del mercado hispano — permite probar estrategias de marketing, comunicación y ventas con riesgo cero
• A nivel micro: Somos el sandbox creativo para agentes de seguros, abogados de inmigración, agentes de real estate y emprendedores latinos — todo accesible, práctico y en tu idioma

Desde predicciones serias hasta simulaciones creativas, hacemos que cada "¿qué pasaría si...?" pueda verse antes de que ocurra.

---

🏆 ¿Por Qué Esta Versión en Español?

El proyecto original tiene +45,000 estrellas en GitHub — uno de los proyectos de IA más virales de 2025/2026. Sin embargo, toda la documentación, interfaz y prompts estaban íntegramente en chino, haciendo el sistema completamente inaccesible para los 500 millones de hispanohablantes del mundo.

Esta adaptación cambia eso:

Característica	Original (chino)	Esta versión (español)
Interfaz de usuario	中文	Español Latino ✅
Razonamiento de agentes	中文	Español Latino ✅
Reportes generados	中文	Español Latino ✅
Documentación	中文 / Inglés	Español Latino ✅
Seeds de ejemplo	Noticias chinas	Seguros · Inmigración · Real Estate ✅
Descarga de reportes	No incluida	TXT + PDF profesional ✅
Encuestas a agentes	Sin descarga	Descarga TXT incluida ✅
Timeouts optimizados	60s / 120s	180s / 300s ✅
Soporte de comunidad	Discord / QQ	Instagram · YouTube · LinkedIn ✅

---

🌐 Demo en Vivo

Prueba la demo en línea del proyecto original para ver MiroFish en acción: mirofish-live-demo

---

📸 Capturas del Sistema en Español

---

🎯 Casos de Uso — Predice Cualquier Cosa

MiroFish no tiene límites de industria. Si puedes describir el contexto en texto, puedes simularlo.

🏪 Negocios y Emprendimiento

Simula cómo reaccionará el mercado ante el lanzamiento de tu producto o servicio antes de invertir un peso.

📱 Marketing y Publicidad

Prueba campañas publicitarias con audiencias simuladas. Descubre qué mensajes conectan y cuáles generan rechazo antes de gastar en pauta.

🎯 Comportamiento del Consumidor

Entiende los patrones de decisión de compra de tu cliente ideal. Simula objeciones, motivaciones y puntos de dolor.

📊 Análisis de Tendencias

Predice cómo evolucionará una tendencia en tu mercado. Anticípate a la competencia con datos simulados.

⚖️ Servicios Legales e Inmigración

Simula el impacto de cambios regulatorios en tu comunidad objetivo. Genera estrategias de comunicación empáticas.

🏥 Seguros y Salud

Predice reacciones ante cambios de primas o nuevas pólizas. Identifica objeciones antes de que existan.

🏠 Real Estate

Simula el comportamiento del mercado inmobiliario ante cambios económicos. Entiende la psicología del comprador.

🎓 Educación e Investigación

Modela comportamientos sociales para estudios académicos. Simula escenarios históricos o futuros.

🏛️ Políticas Públicas

Ensaya el impacto de decisiones de gobierno antes de implementarlas. Reduce el riesgo en la toma de decisiones.

🎬 Contenido y Entretenimiento

Predice finales alternativos de historias. Simula cómo reaccionará tu audiencia ante nuevo contenido.

Regla de oro: Si puedes describir el contexto en un párrafo, MiroFish puede simularlo.

---

🔄 Flujo de Trabajo

1. Construcción del Grafo: Extracción de semillas reales & Inyección de memoria individual y grupal & Construcción de GraphRAG
2. Configuración del Entorno: Extracción de relaciones de entidades & Generación de perfiles de agentes & Inyección de parámetros de simulación
3. Simulación: Simulación paralela en dos plataformas & Análisis automático de requisitos de predicción & Actualización dinámica de memoria temporal
4. Generación de Informe: ReportAgent con conjunto rico de herramientas para interacción profunda con el entorno post-simulación
5. Interacción Profunda: Conversa con cualquier agente del mundo simulado & Envía encuestas al mundo simulado & Descarga reportes y resultados

---

🚀 Inicio Rápido

Opción 1: Docker (Recomendada)

Requisitos Previos

Herramienta	Versión	Descripción	Verificar
Docker	Última	Motor de contenedores	docker -v
Docker Compose	Última	Orquestación	docker compose version

1. Clonar y Configurar

git clone https://github.com/enpixeles-ai/MiroFish.git
cd MiroFish
cp .env.example .env

2. Editar Variables de Entorno

# LLM — Compatible con cualquier API en formato OpenAI
# Recomendado para español: Gemini 3 Flash (Google AI Studio)
LLM_API_KEY=tu_api_key
LLM_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai/
LLM_MODEL_NAME=gemini-3-flash-preview

# Zep Cloud — Memoria de agentes
# Tier gratuito disponible en: https://app.getzep.com/
ZEP_API_KEY=tu_zep_api_key

# URL del backend (cambia tu-ip por tu IP pública si usas VPS)
VITE_API_BASE_URL=http://localhost:5001

3. Construir e Iniciar

docker compose up -d --build

• Frontend: http://localhost:3000
• Backend API: http://localhost:5001

---

Opción 2: Desde el Código Fuente

Requisitos Previos

Herramienta	Versión	Descripción	Verificar
Node.js	18+	Runtime frontend, incluye npm	node -v
Python	≥3.11, ≤3.12	Runtime backend	python --version
uv	Última	Gestor de paquetes Python	uv --version

1. Configurar Variables de Entorno

cp .env.example .env
# Edita .env con tus API keys

2. Instalar Dependencias

# Instalación completa (raíz + frontend + backend)
npm run setup:all

O paso a paso:

npm run setup          # Dependencias Node (raíz + frontend)
npm run setup:backend  # Dependencias Python (crea entorno virtual automáticamente)

3. Iniciar Servicios

npm run dev  # Inicia frontend y backend simultáneamente

Iniciar individualmente:

npm run backend   # Solo backend
npm run frontend  # Solo frontend

---

🔑 LLMs Recomendados para Español

Esta versión está optimizada para generar contenido en español latino. Modelos recomendados por calidad:

Modelo	Proveedor	Base URL	Calidad Español
gemini-3-flash-preview	Google AI Studio	https://generativelanguage.googleapis.com/v1beta/openai/	⭐⭐⭐⭐⭐
gemini-2.0-flash	Google AI Studio	https://generativelanguage.googleapis.com/v1beta/openai/	⭐⭐⭐⭐
deepseek/deepseek-chat	OpenRouter	https://openrouter.ai/api/v1	⭐⭐⭐⭐
llama-3.3-70b-versatile	Groq (gratuito)	https://api.groq.com/openai/v1	⭐⭐⭐
qwen-plus	Alibaba Bailian	https://dashscope.aliyuncs.com/compatible-mode/v1	⭐⭐⭐

Tip: Agrega siempre al final de tu seed material: "Toda la simulación debe generarse exclusivamente en español latino."

---

📋 Formato del Material Semilla

Para mejores resultados en el mercado hispano, estructura tu archivo semilla así:

═══════════════════════════════════════
MIROFISH SEED MATERIAL — [TU SECTOR] [AÑO]
═══════════════════════════════════════

CONTEXTO DEL MERCADO:
- Descripción del sector y situación actual
- Datos demográficos relevantes de tu audiencia
- Tendencias y tensiones del mercado

PERFILES DE PERSONAJES:
- Nombre, edad, origen, ocupación
- Situación específica y necesidades
- Comportamiento digital y canales que usa

CONTEXTO EMOCIONAL:
- Miedos y motivaciones de la comunidad
- Fuentes de información que consultan
- Relación con el servicio/producto

PREGUNTA DE PREDICCIÓN:
¿Qué quieres predecir o simular?

NOTA: Todos los personajes son ficticios con fines de simulación.
IMPORTANTE: Genera todo exclusivamente en español latino.
═══════════════════════════════════════

Formatos soportados: TXT · PDF · MD

---

💬 Comunidad y Soporte

Manuel Peña — EnPíxeles Lab

Agencia de IA para el mercado hispano en Florida

¿Preguntas, sugerencias o quieres reportar un bug? Abre un Issue o contáctanos por Instagram.

---

🤝 Contribuir

¿Quieres mejorar MiroFish para el mercado hispano? ¡Bienvenido!

1. Haz fork de este repositorio
2. Crea tu rama: git checkout -b feat/mi-mejora
3. Commit: git commit -m 'feat: descripción de mi mejora'
4. Push: git push origin feat/mi-mejora
5. Abre un Pull Request

Áreas donde puedes contribuir:

• 🌍 Seeds de ejemplo para más industrias del mercado hispano
• 🎨 Mejoras de UI/UX en español
• 🐛 Corrección de bugs
• 📖 Documentación adicional
• 🔧 Soporte para nuevos LLMs en español

---

📄 Agradecimientos y Licencia

MiroFish fue creado originalmente por 666ghj con soporte estratégico de Shanda Group.

El motor de simulación está impulsado por OASIS (Open Agent Social Interaction Simulations) del equipo CAMEL-AI. ¡Gracias por su contribución al código abierto!

Adaptación completa al español para el mercado hispano: Manuel Peña — EnPíxeles Lab © 2026

Licencia: AGPL-3.0

Si usas este proyecto, por favor mantén los créditos al proyecto original y a esta adaptación al español.

---

📈 Estadísticas del Proyecto Original

---

⭐ Si esta adaptación al español te fue útil, dale una estrella ⭐

Hecho con ❤️ para los 500 millones de hispanohablantes del mundo