MiroFish：群体智能预测引擎，在数字沙盘中推演未来

项目简介

MiroFish 是一个简洁通用的群体智能引擎，由盛趣游戏团队开发，核心理念是”在数字沙盘中排练未来，在无数次模拟中赢得决策”。它通过多智能体技术，从现实世界（新闻、政策草稿、金融信号等）提取种子信息，自动构建一个高保真的平行数字世界，让数千个拥有独立个性、长期记忆和行为逻辑的智能 Agent 在这个世界中自由互动和社会化演进。

你可以从”上帝视角”动态注入变量，精确推演未来轨迹。MiroFish 的定位介于严肃的决策实验室和创意的故事推演沙盘之间——无论是预测政策效果，还是推演小说结局，一切”如果”都能看到结果。

项目获得盛趣游戏官方支持，在 GitHub 拥有超过 5.5 万颗星标，提供 Docker 部署方式。

核心特色功能

多智能体平行世界构建： 从种子材料（数据分析报告、新闻事件、创意故事等）自动构建 Agent 群体，每个 Agent 有独立个性、记忆和行为逻辑，在模拟中涌现集体行为。

上帝视角变量注入： 在模拟过程中实时注入新变量（如政策干预、突发事件），观察不同条件下的演化结果。

预测报告生成： 模拟结束后自动生成详细预测报告，包含趋势分析、关键节点、概率评估等结构化内容。

预置演示场景： 提供武汉大学舆情推演、《红楼梦》失佚结局推演等在线演示，可在 https://666ghj.github.io/mirofish-demo/ 体验。

Docker 一键部署： 提供官方 Docker 镜像，自建服务简单快捷。

安装步骤

前置要求：
– Python 3.10+
– Docker（推荐）
– 网络连接（用于种子信息抓取）

方式一：Docker 安装（推荐）

“`bash

拉取官方镜像

docker pull mirofish/mirofish

运行容器

docker run -d -p 8080:8080 mirofish/mirofish
“`

访问 http://localhost:8080 打开 Web 界面。

方式二：源码安装

“`bash

克隆仓库

git clone https://github.com/666ghj/MiroFish.git
cd MiroFish

安装依赖

pip install -r requirements.txt

启动服务

python run.py
“`

方式三：Python pip 安装

bash pip install mirofish mirofish --help

使用方法

基础工作流：

第一步：准备种子材料

上传你想要分析或预测的原始材料，可以是：
– 新闻报道或政策文件
– 数据分析报告
– 小说或故事文本
– 金融信号或市场数据

第二步：描述预测目标

用自然语言描述你想问的问题，例如：
– “这个政策如果实施，三年后社会反应会怎样？”
– “如果林黛玉没有病亡，贾宝玉的结局会是什么？”

第三步：运行模拟

MiroFish 会自动：
1. 解析种子材料，提取关键实体和关系
2. 生成数千个模拟 Agent
3. 运行多轮社会演化模拟
4. 输出预测报告和平行世界状态

Web 界面操作：

打开 http://localhost:8080
点击”新建预测任务”
上传种子材料或粘贴文本
填写预测目标描述
设置模拟参数（Agent 数量、模拟轮次等）
点击”开始推演”，等待结果

Docker Compose 生产部署：

yaml version: '3.8' services: mirofish: image: mirofish/mirofish ports: - "8080:8080" environment: - MAX_AGENTS=5000 - SIMULATION_ROUNDS=100 volumes: - ./data:/app/data