666ghj · DragonJAR · Apr 9, 2026
diff --git a/README-ES.md b/README-ES.md
@@ -0,0 +1,203 @@
+<div align="center">
+
+<img src="./static/image/MiroFish_logo_compressed.jpeg" alt="MiroFish Logo" width="75%"/>
+
+<a href="https://trendshift.io/repositories/16144" target="_blank"><img src="https://trendshift.io/api/badge/repositories/16144" alt="666ghj%2FMiroFish | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+
+Motor de inteligencia colectiva simple y universal, prediciendo todo
+</br>
+<em>Un Motor de Inteligencia Colectiva Simple y Universal, Prediciendo Todo</em>
+
+<a href="https://www.shanda.com/" target="_blank"><img src="./static/image/shanda_logo.png" alt="666ghj%2MiroFish | Shanda" height="40"/></a>
+
+[![GitHub Stars](https://img.shields.io/github/stars/666ghj/MiroFish?style=flat-square&color=DAA520)](https://github.com/666ghj/MiroFish/stargazers)
+[![GitHub Watchers](https://img.shields.io/github/watchers/666ghj/MiroFish?style=flat-square)](https://github.com/666ghj/MiroFish/watchers)
+[![GitHub Forks](https://img.shields.io/github/forks/666ghj/MiroFish?style=flat-square)](https://github.com/666ghj/MiroFish/network)
+[![Docker](https://img.shields.io/badge/Docker-Build-2496ED?style=flat-square&logo=docker&logoColor=white)](https://hub.docker.com/)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/666ghj/MiroFish)
+
+[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=flat-square&logo=discord&logoColor=white)](http://discord.gg/ePf5aPaHnA)
+[![X](https://img.shields.io/badge/X-Follow-000000?style=flat-square&logo=x&logoColor=white)](https://x.com/mirofish_ai)
+[![Instagram](https://img.shields.io/badge/Instagram-Follow-E4405F?style=flat-square&logo=instagram&logoColor=white)](https://www.instagram.com/mirofish_ai/)
+
+[English](./README.md) | [中文文档](./README-ZH.md) | [Español](./README-ES.md)
+
+</div>
+
+## ⚡ Descripción general
+
+**MiroFish** es un motor de predicción de próxima 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. Dentro de 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. Podés inyectar variables dinámicamente desde una "perspectiva omnisciente" para deducir con precisión trayectorias futuras — **ensayar el futuro en un simulador digital y ganar decisiones tras incontables simulaciones**.
+
+> Solo necesitás: Subir materiales semilla (informes de análisis de datos o historias noveladas interesantes) y describir tus requisitos de predicción en lenguaje natural</br>
+> MiroFish devolverá: Un informe de predicción detallado y un mundo digital de alta fidelidad profundamente interactivo
+
+### Nuestra visión
+
+MiroFish se dedica a crear un espejo de inteligencia colectiva que refleja la realidad. Al capturar la emergencia colectiva desencadenada por interacciones individuales, superamos las limitaciones de la predicción tradicional:
+
+- **A nivel macro**: Somos un laboratorio de ensayo para tomadores de decisiones, permitiendo que políticas y relaciones públicas sean probadas a riesgo cero
+- **A nivel micro**: Somos un sandbox creativo para usuarios individuales — ya sea deduciendo finales de novelas o explorando escenarios imaginativos, todo puede ser divertido, lúdico y accesible
+
+Desde predicciones serias hasta simulaciones lúdicas, hacemos que cada "¿qué pasaría si?" vea su resultado, haciendo posible predecir todo.
+
+## 🌐 Demo en vivo
+
+Visité nuestro entorno de demostración en línea y experimentá una simulación de predicción sobre eventos de opinión pública que preparamos para vos: [mirofish-live-demo](https://666ghj.github.io/mirofish-demo/)
+
+## 📸 Capturas de pantalla
+
+<div align="center">
+<table>
+<tr>
+<td><img src="./static/image/Screenshot/运行截图1.png" alt="Captura 1" width="100%"/></td>
+<td><img src="./static/image/Screenshot/运行截图2.png" alt="Captura 2" width="100%"/></td>
+</tr>
+<tr>
+<td><img src="./static/image/Screenshot/运行截图3.png" alt="Captura 3" width="100%"/></td>
+<td><img src="./static/image/Screenshot/运行截图4.png" alt="Captura 4" width="100%"/></td>
+</tr>
+<tr>
+<td><img src="./static/image/Screenshot/运行截图5.png" alt="Captura 5" width="100%"/></td>
+<td><img src="./static/image/Screenshot/运行截图6.png" alt="Captura 6" width="100%"/></td>
+</tr>
+</table>
+</div>
+
+## 🎬 Videos de demostración
+
+### 1. Simulación de opinión pública de la Universidad de Wuhan + Introducción al proyecto MiroFish
+
+<div align="center">
+<a href="https://www.bilibili.com/video/BV1VYBsBHEMY/" target="_blank"><img src="./static/image/武大模拟演示封面.png" alt="Video demo de MiroFish" width="75%"/></a>
+
+Hacé clic en la imagen para ver el video completo de demostración de predicción usando el "Informe de Opinión Pública de la Universidad de Wuhan" generado por BettaFish
+</div>
+
+### 2. Simulación del final perdido de "Sueño de las Cámaras Rojas"
+
+<div align="center">
+<a href="https://www.bilibili.com/video/BV1cPk3BBExq" target="_blank"><img src="./static/image/红楼梦模拟推演封面.jpg" alt="Video demo de MiroFish" width="75%"/></a>
+
+Hacé clic en la imagen para ver la predicción profunda de MiroFish del final perdido basada en cientos de miles de palabras de los primeros 80 capítulos de "Sueño de las Cámaras Rojas"
+</div>
+
+> **Predicción financiera**, **Predicción de noticias políticas** y más ejemplos próximamente...
+
+## 🔄 Flujo de trabajo
+
+1. **Construcción del grafo**: Extracción de semillas & Inyección de memoria individual/colectiva & Construcción de GraphRAG
+2. **Configuración del entorno**: Extracción de relaciones entre entidades & Generación de personajes & Inyección de configuración de Agentes
+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 amplio conjunto de herramientas para interacción profunda con el entorno post-simulación
+5. **Interacción profunda**: Conversá con cualquier agente del mundo simulado & Interactuá con ReportAgent
+
+## 🚀 Inicio rápido
+
+### Opción 1: Despliegue desde código fuente (Recomendado)
+
+#### Requisitos previos
+
+| Herramienta | Versión | Descripción | Verificar instalación |
+|-------------|---------|-------------|----------------------|
+| **Node.js** | 18+ | Runtime de frontend, incluye npm | `node -v` |
+| **Python** | ≥3.11, ≤3.12 | Runtime de backend | `python --version` |
+| **uv** | Última | Gestor de paquetes Python | `uv --version` |
+
+#### 1. Configurar variables de entorno
+
+```bash
+# Copiar el archivo de configuración de ejemplo
+cp .env.example .env
+
+# Editar el archivo .env y completar las claves API necesarias
+```
+
+**Variables de entorno requeridas:**
+
+```env
+# Configuración de API LLM (soporta cualquier API LLM con formato OpenAI SDK)
+# Recomendado: Modelo Alibaba Qwen-plus vía Bailian Platform: https://bailian.console.aliyun.com/
+# Alto consumo, probá primero simulaciones con menos de 40 rondas
+LLM_API_KEY=tu_api_key
+LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
+LLM_MODEL_NAME=qwen-plus
+
+# Configuración de Zep Cloud
+# La cuota mensual gratuita es suficiente para uso básico: https://app.getzep.com/
+ZEP_API_KEY=tu_zep_api_key
+```
+
+#### 2. Instalar dependencias
+
+```bash
+# Instalación con un clic de todas las dependencias (raíz + frontend + backend)
+npm run setup:all
+```
+
+O instalá paso a paso:
+
+```bash
+# Instalar dependencias Node (raíz + frontend)
+npm run setup
+
+# Instalar dependencias Python (backend, crea entorno virtual automáticamente)
+npm run setup:backend
+```
+
+#### 3. Iniciar servicios
+
+```bash
+# Iniciar frontend y backend (ejecutar desde la raíz del proyecto)
+npm run dev
+```
+
+**URLs de servicios:**
+- Frontend: `http://localhost:3000`
+- Backend API: `http://localhost:5001`
+
+**Iniciar individualmente:**
+
+```bash
+npm run backend   # Iniciar solo el backend
+npm run frontend  # Iniciar solo el frontend
+```
+
+### Opción 2: Despliegue con Docker
+
+```bash
+# 1. Configurar variables de entorno (igual que despliegue desde código fuente)
+cp .env.example .env
+
+# 2. Extraer imagen e iniciar
+docker compose up -d
+```
+
+Lee `.env` del directorio raíz por defecto, mapea puertos `3000 (frontend) / 5001 (backend)`
+
+> La dirección del mirror para descarga más rápida se proporciona como comentarios en `docker-compose.yml`, reemplazá si es necesario.
+
+## 📬 Unite a la conversación
+
+<div align="center">
+<img src="./static/image/QQ群.png" alt="Grupo QQ" width="60%"/>
+</div>
+
+&nbsp;
+
+El equipo de MiroFish está reclutando posiciones de tiempo completo/pasantías. Si te interesan la simulación multi-agente y las aplicaciones de LLM, sentite libre de enviar tu CV a: **mirofish@shanda.com**
+
+## 📄 Agradecimientos
+
+**¡MiroFish ha recibido apoyo estratégico e incubación de Shanda Group!**
+
+El motor de simulación de MiroFish está impulsado por **[OASIS (Open Agent Social Interaction Simulations)](https://github.com/camel-ai/oasis)**, ¡agradecemos sinceramente las contribuciones de código abierto del equipo CAMEL-AI!
+
+## 📈 Estadísticas del proyecto
+
+<a href="https://www.star-history.com/#666ghj/MiroFish&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=666ghj/MiroFish&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=666ghj/MiroFish&type=date&legend=top-left" />
+   <img alt="Gráfico de Star History" src="https://api.star-history.com/svg?repos=666ghj/MiroFish&type=date&legend=top-left" />
+ </picture>
+</a>
diff --git a/README.md b/README.md
@@ -20,7 +20,7 @@
 [![X](https://img.shields.io/badge/X-Follow-000000?style=flat-square&logo=x&logoColor=white)](https://x.com/mirofish_ai)
 [![Instagram](https://img.shields.io/badge/Instagram-Follow-E4405F?style=flat-square&logo=instagram&logoColor=white)](https://www.instagram.com/mirofish_ai/)
 
-[English](./README.md) | [中文文档](./README-ZH.md)
+[English](./README.md) | [中文文档](./README-ZH.md) | [Español](./README-ES.md)
 
 </div>