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>
|
|
|
|
简洁通用的群体智能引擎，预测万物
|
|
</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/)
|
|
|
|
**Sprachen / 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>
|
|
|
|
## ⚡ Überblick
|
|
|
|
**MiroFish** ist eine KI-Prognose-Engine der nächsten Generation, die auf Multi-Agenten-Technologie basiert. Durch die Extraktion von Ausgangsinformationen aus der realen Welt (wie Eilmeldungen, Politikentwürfe oder Finanzsignale) wird automatisch eine hochpräzise parallele digitale Welt aufgebaut. In diesem Raum interagieren Tausende intelligenter Agenten mit unabhängigen Persönlichkeiten, Langzeitgedächtnis und Verhaltenslogik frei und durchlaufen soziale Evolution. Sie können Variablen dynamisch aus der «Gottperspektive» injizieren, um zukünftige Entwicklungen präzise abzuleiten — **proben Sie die Zukunft in einer digitalen Sandbox und treffen Sie Entscheidungen nach unzähligen Simulationen**.
|
|
|
|
> Sie müssen nur: Ausgangsmaterialien hochladen (Datenanalyseberichte oder interessante Geschichten) und Ihre Prognoseanforderungen in natürlicher Sprache beschreiben</br>
|
|
> MiroFish liefert: einen detaillierten Prognosebericht und eine interaktive hochpräzise digitale Welt
|
|
|
|
### Unsere Vision
|
|
|
|
MiroFish widmet sich der Schaffung eines Schwarmintelligenz-Spiegels, der die Realität abbildet. Durch die Erfassung kollektiver Emergenz, die durch individuelle Interaktionen ausgelöst wird, überwinden wir die Grenzen traditioneller Prognosen:
|
|
|
|
- **Auf Makroebene**: Wir sind ein Probelabor für Entscheidungsträger, das Politik und PR risikofrei testen lässt
|
|
- **Auf Mikroebene**: Wir sind eine kreative Sandbox für Einzelnutzer — ob Romanendungen ableiten oder fantasievolle Szenarien erkunden, alles kann unterhaltsam und zugänglich sein
|
|
|
|
Von ernsthaften Prognosen bis zu spielerischen Simulationen — wir lassen jedes «Was wäre, wenn» sein Ergebnis sehen und machen es möglich, alles vorherzusagen.
|
|
|
|
## 🌐 Live-Demo
|
|
|
|
Besuchen Sie unsere Online-Demo-Umgebung und erleben Sie eine Prognosesimulation zu aktuellen Meinungsereignissen, die wir für Sie vorbereitet haben: [mirofish-live-demo](https://666ghj.github.io/mirofish-demo/)
|
|
|
|
## 📸 Screenshots
|
|
|
|
<div align="center">
|
|
<table>
|
|
<tr>
|
|
<td><img src="./static/image/Screenshot/运行截图1.png" alt="Screenshot 1" width="100%"/></td>
|
|
<td><img src="./static/image/Screenshot/运行截图2.png" alt="Screenshot 2" width="100%"/></td>
|
|
</tr>
|
|
<tr>
|
|
<td><img src="./static/image/Screenshot/运行截图3.png" alt="Screenshot 3" width="100%"/></td>
|
|
<td><img src="./static/image/Screenshot/运行截图4.png" alt="Screenshot 4" width="100%"/></td>
|
|
</tr>
|
|
<tr>
|
|
<td><img src="./static/image/Screenshot/运行截图5.png" alt="Screenshot 5" width="100%"/></td>
|
|
<td><img src="./static/image/Screenshot/运行截图6.png" alt="Screenshot 6" width="100%"/></td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
|
|
## 🎬 Demo-Videos
|
|
|
|
### 1. Simulation der öffentlichen Meinung der Universität Wuhan + MiroFish-Projektvorstellung
|
|
|
|
<div align="center">
|
|
<a href="https://www.bilibili.com/video/BV1VYBsBHEMY/" target="_blank"><img src="./static/image/武大模拟演示封面.png" alt="MiroFish Demo-Video" width="75%"/></a>
|
|
|
|
Klicken Sie auf das Bild, um das vollständige Demo-Video zur Prognose mit dem von BettaFish generierten «Bericht zur öffentlichen Meinung der Universität Wuhan» anzusehen
|
|
</div>
|
|
|
|
### 2. Simulation des verlorenen Endes von «Traum der roten Kammer»
|
|
|
|
<div align="center">
|
|
<a href="https://www.bilibili.com/video/BV1cPk3BBExq" target="_blank"><img src="./static/image/红楼梦模拟推演封面.jpg" alt="MiroFish Demo-Video" width="75%"/></a>
|
|
|
|
Klicken Sie auf das Bild, um MiroFishs tiefgreifende Prognose des verlorenen Endes basierend auf Hunderttausenden von Wörtern aus den ersten 80 Kapiteln von «Traum der roten Kammer» anzusehen
|
|
</div>
|
|
|
|
> Weitere Beispiele für **Finanzprognosen**, **politische Nachrichtenprognosen** usw. folgen in Kürze...
|
|
|
|
## 🔄 Arbeitsablauf
|
|
|
|
1. **Graph-Aufbau**: Samenextraktion und Injektion individueller/kollektiver Erinnerung sowie GraphRAG-Konstruktion
|
|
2. **Umgebungseinrichtung**: Extraktion von Entitätsbeziehungen, Persona-Generierung und Agentenkonfigurations-Injektion
|
|
3. **Simulation**: Parallele Simulation auf zwei Plattformen, automatische Analyse der Prognoseanforderungen und dynamische zeitliche Speicheraktualisierungen
|
|
4. **Berichtserstellung**: ReportAgent mit umfangreichem Toolset für tiefe Interaktion mit der post-simulations Umgebung
|
|
5. **Tiefe Interaktion**: Chatten Sie mit jedem Agenten in der simulierten Welt und interagieren Sie mit ReportAgent
|
|
|
|
## 🚀 Schnellstart
|
|
|
|
### Option 1: Quellcode-Bereitstellung (empfohlen)
|
|
|
|
#### Voraussetzungen
|
|
|
|
| Tool | Version | Beschreibung | Installation prüfen |
|
|
|------|---------|-------------|-------------------|
|
|
| **Node.js** | 18+ | Frontend-Laufzeit, inkl. npm | `node -v` |
|
|
| **Python** | ≥3.11, ≤3.12 | Backend-Laufzeit | `python --version` |
|
|
| **uv** | Neueste | Python-Paketmanager | `uv --version` |
|
|
|
|
#### 1. Umgebungsvariablen konfigurieren
|
|
|
|
```bash
|
|
# Beispielkonfigurationsdatei kopieren
|
|
cp .env.example .env
|
|
|
|
# .env-Datei bearbeiten und erforderliche API-Schlüssel eintragen
|
|
```
|
|
|
|
**Erforderliche Umgebungsvariablen:**
|
|
|
|
```env
|
|
# LLM-API-Konfiguration (unterstützt jede LLM-API im OpenAI-SDK-Format)
|
|
# Empfohlen: Alibaba Qwen-plus-Modell über Bailian Platform: https://bailian.console.aliyun.com/
|
|
# Hoher Verbrauch, testen Sie zuerst Simulationen mit weniger als 40 Runden
|
|
LLM_API_KEY=your_api_key
|
|
LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
|
|
LLM_MODEL_NAME=qwen-plus
|
|
|
|
# Zep Cloud-Konfiguration
|
|
# Kostenloses Monatskontingent reicht für einfache Nutzung: https://app.getzep.com/
|
|
ZEP_API_KEY=your_zep_api_key
|
|
```
|
|
|
|
#### 2. Abhängigkeiten installieren
|
|
|
|
```bash
|
|
# Alle Abhängigkeiten mit einem Befehl installieren (Root + Frontend + Backend)
|
|
npm run setup:all
|
|
```
|
|
|
|
Oder schrittweise installieren:
|
|
|
|
```bash
|
|
# Node-Abhängigkeiten installieren (Root + Frontend)
|
|
npm run setup
|
|
|
|
# Python-Abhängigkeiten installieren (Backend, erstellt automatisch virtuelle Umgebung)
|
|
npm run setup:backend
|
|
```
|
|
|
|
#### 3. Dienste starten
|
|
|
|
```bash
|
|
# Frontend und Backend gleichzeitig starten (vom Projektroot aus)
|
|
npm run dev
|
|
```
|
|
|
|
**Dienst-URLs:**
|
|
- Frontend: `http://localhost:3000`
|
|
- Backend-API: `http://localhost:5001`
|
|
|
|
**Einzeln starten:**
|
|
|
|
```bash
|
|
npm run backend # Nur Backend
|
|
npm run frontend # Nur Frontend
|
|
```
|
|
|
|
### Option 2: Docker-Bereitstellung
|
|
|
|
```bash
|
|
# 1. Umgebungsvariablen konfigurieren (wie bei Quellcode-Bereitstellung)
|
|
cp .env.example .env
|
|
|
|
# 2. Image abrufen und starten
|
|
docker compose up -d
|
|
```
|
|
|
|
Liest standardmäßig `.env` aus dem Root-Verzeichnis, mappt Ports `3000 (Frontend) / 5001 (Backend)`
|
|
|
|
> Mirror-Adresse für schnelleres Herunterladen ist als Kommentar in `docker-compose.yml` angegeben, bei Bedarf ersetzen.
|
|
|
|
## 📬 Werden Sie Teil der Community
|
|
|
|
<div align="center">
|
|
<img src="./static/image/QQ群.png" alt="QQ-Gruppe" width="60%"/>
|
|
</div>
|
|
|
|
|
|
|
|
Das MiroFish-Team sucht Vollzeit-/Praktikanten. Wenn Sie sich für Multi-Agenten-Simulation und LLM-Anwendungen interessieren, senden Sie Ihren Lebenslauf an: **mirofish@shanda.com**
|
|
|
|
## 📄 Danksagungen
|
|
|
|
**MiroFish hat strategische Unterstützung und Inkubation von Shanda Group erhalten!**
|
|
|
|
MiroFishs Simulations-Engine wird von **[OASIS (Open Agent Social Interaction Simulations)](https://github.com/camel-ai/oasis)** angetrieben. Wir danken dem CAMEL-AI-Team herzlich für ihre Open-Source-Beiträge!
|
|
|
|
## 📈 Projektstatistiken
|
|
|
|
<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>
|