204 lines
9.7 KiB
Markdown
204 lines
9.7 KiB
Markdown
<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>
|
|
|
|
简洁通用的群体智能引擎，预测万物
|
|
</br>
|
|
<em>A Simple and Universal Swarm Intelligence Engine, Predicting Anything</em>
|
|
|
|
<a href="https://www.shanda.com/" target="_blank"><img src="./static/image/shanda_logo.png" alt="666ghj%2MiroFish | Shanda" height="40"/></a>
|
|
|
|
[](https://github.com/666ghj/MiroFish/stargazers)
|
|
[](https://github.com/666ghj/MiroFish/watchers)
|
|
[](https://github.com/666ghj/MiroFish/network)
|
|
[](https://hub.docker.com/)
|
|
[](https://deepwiki.com/666ghj/MiroFish)
|
|
|
|
[](http://discord.gg/ePf5aPaHnA)
|
|
[](https://x.com/mirofish_ai)
|
|
[](https://www.instagram.com/mirofish_ai/)
|
|
|
|
**Idiomas / Languages:** [English](./README.md) · [中文](./README-ZH.md) · [Español](./README-ES.md) · [Français](./README-FR.md) · [Português](./README-PT.md) · [Русский](./README-RU.md) · [Deutsch](./README-DE.md)
|
|
|
|
</div>
|
|
|
|
## ⚡ Descripción general
|
|
|
|
**MiroFish** es un motor de predicción con IA de nueva generación impulsado por tecnología multiagente. 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 de comportamiento interactúan libremente y evolucionan socialmente. Puedes inyectar variables dinámicamente desde una «vista de Dios» para deducir con precisión trayectorias futuras — **ensaya el futuro en un sandbox digital y gana decisiones tras innumerables simulaciones**.
|
|
|
|
> Solo necesitas: subir materiales semilla (informes de análisis de datos o historias interesantes) y describir tus requisitos de predicción en lenguaje natural</br>
|
|
> MiroFish devolverá: un informe de predicción detallado y un mundo digital interactivo de alta fidelidad
|
|
|
|
### Nuestra visión
|
|
|
|
MiroFish se dedica a crear un espejo de inteligencia colectiva que refleje la realidad. Al capturar la emergencia colectiva provocada por las interacciones individuales, superamos las limitaciones de la predicción tradicional:
|
|
|
|
- **A nivel macro**: somos un laboratorio de ensayo para tomadores de decisiones, permitiendo probar políticas y relaciones públicas sin riesgo
|
|
- **A nivel micro**: somos un sandbox creativo para usuarios individuales — ya sea deducir finales de novelas o explorar escenarios imaginativos, todo puede ser divertido y accesible
|
|
|
|
Desde predicciones serias hasta simulaciones lúdicas, permitimos que cada «¿y si?» vea su resultado, haciendo posible predecir cualquier cosa.
|
|
|
|
## 🌐 Demo en línea
|
|
|
|
Visita nuestro entorno de demostración en línea y experimenta una simulación de predicción sobre eventos de opinión pública que hemos preparado para ti: [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 MiroFish" width="75%"/></a>
|
|
|
|
Haz clic en la imagen para ver el video completo de predicción usando el «Informe de opinión pública de Wuhan» generado por BettaFish
|
|
</div>
|
|
|
|
### 2. Simulación del final perdido de «Sueño en el pabellón rojo»
|
|
|
|
<div align="center">
|
|
<a href="https://www.bilibili.com/video/BV1cPk3BBExq" target="_blank"><img src="./static/image/红楼梦模拟推演封面.jpg" alt="Video demo MiroFish" width="75%"/></a>
|
|
|
|
Haz clic en la imagen para ver la predicción profunda de MiroFish sobre el final perdido basada en cientos de miles de palabras de los primeros 80 capítulos de «Sueño en el pabellón rojo»
|
|
</div>
|
|
|
|
> Más ejemplos de **predicción financiera**, **predicción de noticias políticas**, etc. próximamente...
|
|
|
|
## 🔄 Flujo de trabajo
|
|
|
|
1. **Construcción del grafo**: Extracción de semillas e inyección de memoria individual/colectiva y construcción GraphRAG
|
|
2. **Configuración del entorno**: Extracción de relaciones entre entidades, generación de personas e inyección de configuración de agentes
|
|
3. **Simulación**: Simulación paralela en doble plataforma, análisis automático de requisitos de predicción y actualizaciones dinámicas de memoria temporal
|
|
4. **Generación de informes**: ReportAgent con un rico conjunto de herramientas para interacción profunda con el entorno post-simulación
|
|
5. **Interacción profunda**: Chatea con cualquier agente del mundo simulado e interactúa 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+ | Entorno de ejecución frontend, incluye npm | `node -v` |
|
|
| **Python** | ≥3.11, ≤3.12 | Entorno de ejecución 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 (compatible con cualquier API LLM con formato OpenAI SDK)
|
|
# Recomendado: modelo Qwen-plus de Alibaba vía Bailian Platform: https://bailian.console.aliyun.com/
|
|
# Alto consumo, prueba primero simulaciones con menos de 40 rondas
|
|
LLM_API_KEY=your_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 simple: https://app.getzep.com/
|
|
ZEP_API_KEY=your_zep_api_key
|
|
```
|
|
|
|
#### 2. Instalar dependencias
|
|
|
|
```bash
|
|
# Instalación de todas las dependencias con un solo comando (raíz + frontend + backend)
|
|
npm run setup:all
|
|
```
|
|
|
|
O instalar 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 servicio:**
|
|
- Frontend: `http://localhost:3000`
|
|
- API Backend: `http://localhost:5001`
|
|
|
|
**Iniciar por separado:**
|
|
|
|
```bash
|
|
npm run backend # Solo backend
|
|
npm run frontend # Solo frontend
|
|
```
|
|
|
|
### Opción 2: Despliegue con Docker
|
|
|
|
```bash
|
|
# 1. Configurar variables de entorno (igual que despliegue desde código)
|
|
cp .env.example .env
|
|
|
|
# 2. Descargar imagen e iniciar
|
|
docker compose up -d
|
|
```
|
|
|
|
Lee `.env` desde el 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`, reemplazar si es necesario.
|
|
|
|
## 📬 Únete a la conversación
|
|
|
|
<div align="center">
|
|
<img src="./static/image/QQ群.png" alt="Grupo QQ" width="60%"/>
|
|
</div>
|
|
|
|
|
|
|
|
El equipo de MiroFish está reclutando posiciones de tiempo completo/prácticas. Si te interesan la simulación multiagente y las aplicaciones LLM, envía tu currículum 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 al equipo CAMEL-AI por sus contribuciones de código abierto!
|
|
|
|
## 📈 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="Star History Chart" src="https://api.star-history.com/svg?repos=666ghj/MiroFish&type=date&legend=top-left" />
|
|
</picture>
|
|
</a>
|