204 lines
13 KiB
Markdown
204 lines
13 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/)
|
||
|
||
**Языки / 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>
|
||
|
||
## ⚡ Обзор
|
||
|
||
**MiroFish** — это AI-движок прогнозирования нового поколения на основе мультиагентных технологий. Извлекая исходную информацию из реального мира (например, срочные новости, проекты политик или финансовые сигналы), он автоматически создаёт высокоточный параллельный цифровой мир. В этом пространстве тысячи интеллектуальных агентов с независимыми личностями, долгосрочной памятью и поведенческой логикой свободно взаимодействуют и социально эволюционируют. Вы можете динамически вводить переменные с «божественной перспективы» для точного прогнозирования будущих траекторий — **репетируйте будущее в цифровой песочнице и принимайте решения после бесчисленных симуляций**.
|
||
|
||
> Вам нужно только: загрузить исходные материалы (аналитические отчёты или интересные истории) и описать требования к прогнозу на естественном языке</br>
|
||
> MiroFish вернёт: подробный отчёт прогноза и интерактивный высокоточный цифровой мир
|
||
|
||
### Наше видение
|
||
|
||
MiroFish стремится создать зеркало коллективного интеллекта, отражающее реальность. Захватывая коллективное возникновение, вызванное индивидуальными взаимодействиями, мы преодолеваем ограничения традиционного прогнозирования:
|
||
|
||
- **На макроуровне**: мы — лаборатория репетиций для лиц, принимающих решения, позволяющая тестировать политику и PR без риска
|
||
- **На микроуровне**: мы — творческая песочница для отдельных пользователей — будь то вывод финалов романов или исследование воображаемых сценариев, всё может быть интересным и доступным
|
||
|
||
От серьёзных прогнозов до игровых симуляций — мы позволяем каждому «а что, если» увидеть результат, делая возможным прогнозирование чего угодно.
|
||
|
||
## 🌐 Онлайн-демо
|
||
|
||
Посетите нашу онлайн-демонстрацию и опробуйте симуляцию прогноза по актуальным событиям общественного мнения, которую мы подготовили для вас: [mirofish-live-demo](https://666ghj.github.io/mirofish-demo/)
|
||
|
||
## 📸 Скриншоты
|
||
|
||
<div align="center">
|
||
<table>
|
||
<tr>
|
||
<td><img src="./static/image/Screenshot/运行截图1.png" alt="Скриншот 1" width="100%"/></td>
|
||
<td><img src="./static/image/Screenshot/运行截图2.png" alt="Скриншот 2" width="100%"/></td>
|
||
</tr>
|
||
<tr>
|
||
<td><img src="./static/image/Screenshot/运行截图3.png" alt="Скриншот 3" width="100%"/></td>
|
||
<td><img src="./static/image/Screenshot/运行截图4.png" alt="Скриншот 4" width="100%"/></td>
|
||
</tr>
|
||
<tr>
|
||
<td><img src="./static/image/Screenshot/运行截图5.png" alt="Скриншот 5" width="100%"/></td>
|
||
<td><img src="./static/image/Screenshot/运行截图6.png" alt="Скриншот 6" width="100%"/></td>
|
||
</tr>
|
||
</table>
|
||
</div>
|
||
|
||
## 🎬 Демонстрационные видео
|
||
|
||
### 1. Симуляция общественного мнения Уханьского университета + представление проекта MiroFish
|
||
|
||
<div align="center">
|
||
<a href="https://www.bilibili.com/video/BV1VYBsBHEMY/" target="_blank"><img src="./static/image/武大模拟演示封面.png" alt="Демо-видео MiroFish" width="75%"/></a>
|
||
|
||
Нажмите на изображение, чтобы посмотреть полное демо-видео прогноза с использованием «Отчёта об общественном мнении Уханьского университета», сгенерированного BettaFish
|
||
</div>
|
||
|
||
### 2. Симуляция утерянного финала «Сон в красном тереме»
|
||
|
||
<div align="center">
|
||
<a href="https://www.bilibili.com/video/BV1cPk3BBExq" target="_blank"><img src="./static/image/红楼梦模拟推演封面.jpg" alt="Демо-видео MiroFish" width="75%"/></a>
|
||
|
||
Нажмите на изображение, чтобы увидеть глубокий прогноз MiroFish утерянного финала на основе сотен тысяч слов из первых 80 глав «Сна в красном тереме»
|
||
</div>
|
||
|
||
> Скоро появятся примеры **финансового прогнозирования**, **прогнозирования политических новостей** и другие...
|
||
|
||
## 🔄 Рабочий процесс
|
||
|
||
1. **Построение графа**: Извлечение исходных данных и инъекция индивидуальной/коллективной памяти и построение GraphRAG
|
||
2. **Настройка среды**: Извлечение связей между сущностями, генерация персон и инъекция конфигурации агентов
|
||
3. **Симуляция**: Параллельная симуляция на двух платформах, автоматический разбор требований к прогнозу и динамическое обновление временной памяти
|
||
4. **Генерация отчётов**: ReportAgent с богатым набором инструментов для глубокого взаимодействия со средой после симуляции
|
||
5. **Глубокое взаимодействие**: Общайтесь с любым агентом в симулированном мире и взаимодействуйте с ReportAgent
|
||
|
||
## 🚀 Быстрый старт
|
||
|
||
### Вариант 1: Развёртывание из исходного кода (рекомендуется)
|
||
|
||
#### Требования
|
||
|
||
| Инструмент | Версия | Описание | Проверка установки |
|
||
|------|---------|-------------|-------------------|
|
||
| **Node.js** | 18+ | Среда выполнения frontend, включает npm | `node -v` |
|
||
| **Python** | ≥3.11, ≤3.12 | Среда выполнения backend | `python --version` |
|
||
| **uv** | Последняя | Менеджер пакетов Python | `uv --version` |
|
||
|
||
#### 1. Настройка переменных окружения
|
||
|
||
```bash
|
||
# Скопировать пример конфигурационного файла
|
||
cp .env.example .env
|
||
|
||
# Отредактировать файл .env и заполнить необходимые API-ключи
|
||
```
|
||
|
||
**Обязательные переменные окружения:**
|
||
|
||
```env
|
||
# Конфигурация LLM API (поддерживает любой LLM API в формате OpenAI SDK)
|
||
# Рекомендуется: модель Qwen-plus от Alibaba через Bailian Platform: https://bailian.console.aliyun.com/
|
||
# Высокое потребление, сначала попробуйте симуляции менее 40 раундов
|
||
LLM_API_KEY=your_api_key
|
||
LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
|
||
LLM_MODEL_NAME=qwen-plus
|
||
|
||
# Конфигурация Zep Cloud
|
||
# Бесплатная месячная квота достаточна для простого использования: https://app.getzep.com/
|
||
ZEP_API_KEY=your_zep_api_key
|
||
```
|
||
|
||
#### 2. Установка зависимостей
|
||
|
||
```bash
|
||
# Установка всех зависимостей одной командой (корень + frontend + backend)
|
||
npm run setup:all
|
||
```
|
||
|
||
Или пошаговая установка:
|
||
|
||
```bash
|
||
# Установить Node-зависимости (корень + frontend)
|
||
npm run setup
|
||
|
||
# Установить Python-зависимости (backend, автоматически создаёт виртуальное окружение)
|
||
npm run setup:backend
|
||
```
|
||
|
||
#### 3. Запуск сервисов
|
||
|
||
```bash
|
||
# Запустить frontend и backend (из корня проекта)
|
||
npm run dev
|
||
```
|
||
|
||
**Адреса сервисов:**
|
||
- Frontend: `http://localhost:3000`
|
||
- Backend API: `http://localhost:5001`
|
||
|
||
**Запуск по отдельности:**
|
||
|
||
```bash
|
||
npm run backend # Только backend
|
||
npm run frontend # Только frontend
|
||
```
|
||
|
||
### Вариант 2: Развёртывание через Docker
|
||
|
||
```bash
|
||
# 1. Настроить переменные окружения (как при развёртывании из исходников)
|
||
cp .env.example .env
|
||
|
||
# 2. Загрузить образ и запустить
|
||
docker compose up -d
|
||
```
|
||
|
||
По умолчанию читает `.env` из корневого каталога, порты `3000 (frontend) / 5001 (backend)`
|
||
|
||
> Адрес зеркала для более быстрой загрузки указан в комментариях в `docker-compose.yml`, при необходимости замените.
|
||
|
||
## 📬 Присоединяйтесь к обсуждению
|
||
|
||
<div align="center">
|
||
<img src="./static/image/QQ群.png" alt="Группа QQ" width="60%"/>
|
||
</div>
|
||
|
||
|
||
|
||
Команда MiroFish набирает сотрудников на полную занятость/стажировку. Если вас интересуют мультиагентная симуляция и LLM-приложения, отправляйте резюме на: **mirofish@shanda.com**
|
||
|
||
## 📄 Благодарности
|
||
|
||
**MiroFish получил стратегическую поддержку и инкубацию от Shanda Group!**
|
||
|
||
Движок симуляции MiroFish работает на **[OASIS (Open Agent Social Interaction Simulations)](https://github.com/camel-ai/oasis)**. Мы искренне благодарим команду CAMEL-AI за их вклад в open source!
|
||
|
||
## 📈 Статистика проекта
|
||
|
||
<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>
|