项目介绍 快速开始 学习路径 项目截图 11 贡献者 2 增长趋势 代码统计 生态关系 项目时间线 项目竞品 依赖分析 上榜历史

MiroFish 5分钟快速开始

快速部署MiroFish，体验群体智能预测引擎，通过模拟数字世界推演未来走向。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Node.js 18+ 必需
Python >=3.11, <=3.12 必需

所需工具

uv

Python包管理器

必需
Docker

可选，用于容器化部署

操作步骤

1

克隆项目

从GitHub克隆MiroFish源码到本地。

克隆仓库 
git clone https://github.com/666ghj/MiroFish.git

预期结果：：克隆完成后，进入项目目录：cd MiroFish

确保网络连接正常，或使用镜像加速。

2

安装依赖

使用uv安装Python依赖，确保环境配置正确。

安装所有依赖 
uv sync

预期结果：：依赖安装成功，无错误信息。

如果uv未安装，先运行：pip install uv。

3

启动服务

启动前端和后端服务，快速运行MiroFish。

启动后端API服务 
uv run python app.py
在另一个终端启动前端服务 
npm run dev

预期结果：：后端运行在 http://localhost:5001，前端运行在 http://localhost:3000。

确保Node.js已安装，前端依赖会自动安装。

验证部署成功

访问前端界面，确认服务正常运行。

浏览器打开 http://localhost:3000 显示MiroFish界面
后端API http://localhost:5001 返回健康状态

快速提示

部署

使用Docker一键部署：docker-compose up

快速体验

在线Demo体验：访问 mirofish-live-demo

配置

环境变量配置参考根目录.env.example

常见问题

1

uv命令未找到

安装uv：pip install uv

2

端口被占用

修改.env文件中的端口号或停止占用进程

3

Node.js版本过低

升级Node.js到18或更高版本

下一步

上传种子材料

尝试上传文本如新闻或故事，进行预测推演

探索交互功能

在数字世界中与智能体对话，观察模拟结果

查看文档

访问项目文档了解更多高级用法和配置

相关项目推荐

public-apis

public-apis/public-apis

免费API资源汇总列表

415k Python
EbookFoundation

EbookFoundation/free-programming-books

📚 免费提供的编程书籍

384k Python
donnemartin

donnemartin/system-design-primer

学习如何设计大规模系统。为系统设计面试做准备。包含Anki记忆卡片。

341k Python
vinta

vinta/awesome-python

精心整理的优质Python框架、库、软件及资源列表

265k Python
TheAlgorithms

TheAlgorithms/Python

所有算法均使用Python实现

218k Python
Significant-Gravitas

Significant-Gravitas/AutoGPT

AutoGPT致力于实现人人可用的普惠AI，让每个人都能使用和构建AI。我们的使命是提供工具，让您专注于重要事务。

178k Python
助手