204 lines
9.6 KiB
Markdown
204 lines
9.6 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>
|
|
|
|
Motor d'intel·ligència col·lectiva concís i universal, predient-ho tot
|
|
</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/)
|
|
|
|
[English](./README.md) | [中文文档](./README-ZH.md) | [Español](./README-ES.md) | [Català](./README-CA.md)
|
|
|
|
</div>
|
|
|
|
## ⚡ Visió general
|
|
|
|
**MiroFish** és un motor de predicció de nova generació impulsat per tecnologia multi-agent. Extraient informació llavor del món real (com ara notícies d'última hora, esborranys de polítiques o senyals financeres), construeix automàticament un món digital paral·lel d'alta fidelitat. Dins d'aquest espai, milers d'agents intel·ligents amb personalitats independents, memòria a llarg termini i lògica conductual interactuen lliurement i experimenten evolució social. Pots injectar variables dinàmicament des d'una "perspectiva omniscient" per deduir amb precisió trajectòries futures — **assaja el futur en un simulador digital i guanya decisions després d'incontables simulacions**.
|
|
|
|
> Només necessites: Pujar materials llavor (informes d'anàlisi de dades o històries novel·lades interessants) i descriure els teus requisits de predicció en llenguatge natural</br>
|
|
> MiroFish retornarà: Un informe de predicció detallat i un món digital d'alta fidelitat profundament interactiu
|
|
|
|
### La nostra visió
|
|
|
|
MiroFish es dedica a crear un mirall d'intel·ligència col·lectiva que reflecteix la realitat. Capturant l'emergència col·lectiva desencadenada per les interaccions individuals, superem les limitacions de la predicció tradicional:
|
|
|
|
- **A nivell macro**: Som un laboratori d'assaig per a decisors, que permet provar polítiques i relacions públiques amb risc zero
|
|
- **A nivell micro**: Som un sandbox creatiu per a usuaris individuals — ja sigui deduint finals de novel·les o explorant escenaris imaginatius, tot pot ser divertit, lúdic i accessible
|
|
|
|
Des de prediccions serioses fins a simulacions lúdiques, fem que cada "i si...?" vegi el seu resultat, fent possible predir-ho tot.
|
|
|
|
## 🌐 Demo en viu
|
|
|
|
Visita el nostre entorn de demostració en línia i experimenta una simulació de predicció sobre esdeveniments d'opinió pública que hem preparat per a tu: [mirofish-live-demo](https://666ghj.github.io/mirofish-demo/)
|
|
|
|
## 📸 Captures 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>
|
|
|
|
## 🎬 Vídeos de demostració
|
|
|
|
### 1. Simulació d'opinió pública de la Universitat de Wuhan + Introducció al projecte MiroFish
|
|
|
|
<div align="center">
|
|
<a href="https://www.bilibili.com/video/BV1VYBsBHEMY/" target="_blank"><img src="./static/image/武大模拟演示封面.png" alt="Vídeo demo de MiroFish" width="75%"/></a>
|
|
|
|
Fes clic a la imatge per veure el vídeo de demostració complet de predicció usant l'"Informe d'Opinió Pública de la Universitat de Wuhan" generat per BettaFish
|
|
</div>
|
|
|
|
### 2. Simulació del final perdut de "El somni de la cambra vermella"
|
|
|
|
<div align="center">
|
|
<a href="https://www.bilibili.com/video/BV1cPk3BBExq" target="_blank"><img src="./static/image/红楼梦模拟推演封面.jpg" alt="Vídeo demo de MiroFish" width="75%"/></a>
|
|
|
|
Fes clic a la imatge per veure la predicció profunda de MiroFish del final perdut basada en centenars de milers de paraules dels primers 80 capítols de "El somni de la cambra vermella"
|
|
</div>
|
|
|
|
> **Predicció financera**, **Predicció de notícies polítiques** i més exemples properament...
|
|
|
|
## 🔄 Flux de treball
|
|
|
|
1. **Construcció del graf**: Extracció de llavors & Injecció de memòria individual/col·lectiva & Construcció de GraphRAG
|
|
2. **Configuració de l'entorn**: Extracció de relacions entre entitats & Generació de persones & Injecció de configuració d'Agents
|
|
3. **Simulació**: Simulació paral·lela en dues plataformes & Anàlisi automàtica de requisits de predicció & Actualitzacions dinàmiques de memòria temporal
|
|
4. **Generació de l'informe**: ReportAgent amb conjunt d'eines avançat per a la interacció profunda amb l'entorn post-simulació
|
|
5. **Interacció profunda**: Xateja amb qualsevol agent del món simulat & Interactua amb ReportAgent
|
|
|
|
## 🚀 Inici ràpid
|
|
|
|
### Opció 1: Desplegament des del codi font (Recomanat)
|
|
|
|
#### Requisits previs
|
|
|
|
| Eina | Versió | Descripció | Verificar instal·lació |
|
|
|------|--------|------------|------------------------|
|
|
| **Node.js** | 18+ | Runtime de frontend, inclou npm | `node -v` |
|
|
| **Python** | ≥3.11, ≤3.12 | Runtime de backend | `python --version` |
|
|
| **uv** | Última | Gestor de paquets Python | `uv --version` |
|
|
|
|
#### 1. Configurar les variables d'entorn
|
|
|
|
```bash
|
|
# Copiar el fitxer de configuració d'exemple
|
|
cp .env.example .env
|
|
|
|
# Editar el fitxer .env i omplir les claus API necessàries
|
|
```
|
|
|
|
**Variables d'entorn requerides:**
|
|
|
|
```env
|
|
# Configuració de l'API LLM (suporta qualsevol API LLM amb format OpenAI SDK)
|
|
# Recomanat: Model Alibaba Qwen-plus via Bailian Platform: https://bailian.console.aliyun.com/
|
|
# Alt consum, prova primer simulacions amb menys de 40 rondes
|
|
LLM_API_KEY=la_teva_api_key
|
|
LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
|
|
LLM_MODEL_NAME=qwen-plus
|
|
|
|
# Configuració de Zep Cloud
|
|
# La quota mensual gratuïta és suficient per a un ús bàsic: https://app.getzep.com/
|
|
ZEP_API_KEY=la_teva_zep_api_key
|
|
```
|
|
|
|
#### 2. Instal·lar les dependències
|
|
|
|
```bash
|
|
# Instal·lació amb un clic de totes les dependències (arrel + frontend + backend)
|
|
npm run setup:all
|
|
```
|
|
|
|
O instal·la pas a pas:
|
|
|
|
```bash
|
|
# Instal·lar dependències Node (arrel + frontend)
|
|
npm run setup
|
|
|
|
# Instal·lar dependències Python (backend, crea l'entorn virtual automàticament)
|
|
npm run setup:backend
|
|
```
|
|
|
|
#### 3. Iniciar els serveis
|
|
|
|
```bash
|
|
# Iniciar frontend i backend (executar des de l'arrel del projecte)
|
|
npm run dev
|
|
```
|
|
|
|
**URLs dels serveis:**
|
|
- Frontend: `http://localhost:3000`
|
|
- Backend API: `http://localhost:5001`
|
|
|
|
**Iniciar individualment:**
|
|
|
|
```bash
|
|
npm run backend # Iniciar només el backend
|
|
npm run frontend # Iniciar només el frontend
|
|
```
|
|
|
|
### Opció 2: Desplegament amb Docker
|
|
|
|
```bash
|
|
# 1. Configurar les variables d'entorn (igual que el desplegament des del codi font)
|
|
cp .env.example .env
|
|
|
|
# 2. Obtenir la imatge i iniciar
|
|
docker compose up -d
|
|
```
|
|
|
|
Llegeix `.env` del directori arrel per defecte, mapeja els ports `3000 (frontend) / 5001 (backend)`
|
|
|
|
> L'adreça del mirror per a una descàrrega més ràpida es proporciona com a comentaris a `docker-compose.yml`, substitueix-la si cal.
|
|
|
|
## 📬 Uneix-te a la conversa
|
|
|
|
<div align="center">
|
|
<img src="./static/image/QQ群.png" alt="Grup QQ" width="60%"/>
|
|
</div>
|
|
|
|
|
|
|
|
L'equip de MiroFish està recrutant posicions a temps complet/pràctiques. Si t'interessen la simulació multi-agent i les aplicacions de LLM, no dubtis a enviar el teu CV a: **mirofish@shanda.com**
|
|
|
|
## 📄 Agraïments
|
|
|
|
**MiroFish ha rebut suport estratègic i incubació de Shanda Group!**
|
|
|
|
El motor de simulació de MiroFish és impulsat per **[OASIS (Open Agent Social Interaction Simulations)](https://github.com/camel-ai/oasis)**. Agraïm sincerament les contribucions de codi obert de l'equip CAMEL-AI!
|
|
|
|
## 📈 Estadístiques del projecte
|
|
|
|
<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àfic de l'historial d'estrelles" src="https://api.star-history.com/svg?repos=666ghj/MiroFish&type=date&legend=top-left" />
|
|
</picture>
|
|
</a>
|