ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

MiroFish 部署实战:三步从一条命令启动到能改代码

MiroFish 部署实战:三步从一条命令启动到能改代码 MiroFish 部署实战三步从一条命令启动到能改代码【免费下载链接】MiroFishA Simple and Universal Swarm Intelligence Engine, Predicting Anything. 简洁通用的群体智能引擎预测万物项目地址: https://gitcode.com/GitHub_Trending/mi/MiroFishMiroFish 是一款群体智能预测引擎上传一份种子材料它就构建出平行数字世界用智能体交互推演未来走向。这篇教程带你完成 MiroFish 部署一条命令启动、前后端拆开跑、直到能改代码。下面三站按操作复杂度递进对号入座即可一条命令跑起来只想看效果→把后端和前端拆开来启动想自己托管、改配置→打开调试开关进入可开发状态要改代码。中途卡住了直接翻到文末的「排障速查」。一条命令跑起来前置条件你的机器上要有 Docker 和 Docker Compose没有的话先按 Docker 官方文档装好。然后拿到项目代码git clone https://gitcode.com/GitHub_Trending/mi/MiroFish cd MiroFish启动命令在项目根目录执行docker-compose up -d⚠️ 这条命令会自动拉取 MiroFish 镜像并在后台启动服务。首次运行因为要拉镜像可能需要一些时间耐心等一会儿。启动成功后浏览器访问 http://localhost:3000 即可打开 MiroFish 的 Web 界面。什么算成功顺带说一句为什么 Docker 能让部署简单到一条命令因为它用 namespace 和 cgroups 给每个容器提供独立的网络、进程、文件系统等资源容器之间相互隔离相当于把整个应用栈塞进一个独立小系统里你不用在本机凑环境。延伸阅读Docker 的三个核心概念镜像是一个只读模板包含运行应用所需的代码、运行时、库、环境变量和配置文件容器是镜像的运行实例可以被创建、启动、停止、删除仓库则是存放镜像的地方。日常部署打交道最多的就是这三个词。访问 http://localhost:3000看到 MiroFish 的启动页面把后端和前端拆开来启动想自己托管服务、改配置就把前后端拆开分别跑。后端拉起进入后端目录建虚拟环境、装依赖、启动cd MiroFish/backend python -m venv venv source venv/bin/activate # Linux/Mac venv\Scripts\activate # Windows pip install -r requirements.txt python run.py 虚拟环境把依赖关在 venv 里隔离不同项目的版本冲突激活后安装的包只对当前项目生效。后端默认监听 5001 端口启动无报错即成功。前端拉起再开一个终端进前端目录装依赖并启动开发服务cd ../frontend npm install npm run dev⚠️ npm 安装依赖时会从网络拉包网络不佳容易超时如果安装报错删掉本地的 node_modules 目录后重装一次通常能解决。前端跑在 http://localhost:3000开发服务器会把/api请求代理到 5001 端口的后端所以浏览器只需认 3000 一个入口。之所以前后端拆开部署是因为后端只提供 API 接口前端调用接口取数并渲染两边可以独立开发、独立部署——改界面不用动后端改业务逻辑不用重打前端。 这类前后端分离一般走 RESTful API一组约束和风格化约定前端用统一的方式向后端要数据、交数据。可改哪些配置配置都收在环境变量模板里复制一份再按需修改cd .. cp .env.example .env编辑.env填入你的 API 密钥等环境变量例如LLM_API_KEY、ZEP_API_KEY等后端 后端入口 启动时会读取并校验这份配置缺项会直接报错提示。后端服务启动成功无报错信息前端服务启动成功访问 http://localhost:3000 能看到图形界面尝试上传文件系统能正常处理打开调试开关进入可开发状态要改代码、加功能就需要一套完整的开发环境源码 前后端两套依赖 配好的.env。环境模板git clone https://gitcode.com/GitHub_Trending/mi/MiroFish cd MiroFish # 安装后端依赖 cd backend pip install -r requirements.txt # 安装前端依赖 cd ../frontend npm install复制环境变量模板并填好密钥cd .. cp .env.example .env调试启动分别在后端、前端各开一个终端# 后端开启调试模式 cd backend python run.py --debug# 前端开发服务器 cd ../frontend npm run dev--debug参数启用后端的调试模式改代码能更快反馈开发过程中定位和解决问题都更省力。改哪块代码去哪看开发环境启动后改动代码可以实时看到效果。核心代码分布后端服务backend/app/API 路由、业务逻辑、工具函数都在这里前端组件frontend/src/components/页面的各步骤组件按 Step 划分顺带说一句开发环境与生产环境的差别开发环境开着调试模式方便随时改、随时看生产环境则关掉调试优先保证性能、安全和稳定。开发服务器启动成功调试模式正常工作修改代码后系统能实时更新能够正常提交代码到版本控制系统排障速查症状可能原因解决办法端口冲突启动时报端口已被占用修改 docker-compose.yml 中的端口映射见下方示例依赖安装失败后端依赖安装时出现错误先升级 pip再重装依赖见下方示例启动后无法访问服务启动成功但浏览器访问不到检查防火墙设置确保 3000 和 5001 端口已开放把占用端口的服务挪到别的端口ports: - 3001:3000 # 将 3000 端口映射到主机的 3001 端口 - 5002:5001 # 将 5001 端口映射到主机的 5002 端口依赖装不上时升级 pip 后重试pip install --upgrade pip pip install -r requirements.txt收尾用一次真实预测验收无论你走哪一站最后都按这个动作验收一遍访问 http://localhost:3000 应看到 MiroFish 启动页上传一份报告文件看到预测结果正常生成从 clone 到跑通花了多久、卡在哪一步评论区聊聊。【免费下载链接】MiroFishA Simple and Universal Swarm Intelligence Engine, Predicting Anything. 简洁通用的群体智能引擎预测万物项目地址: https://gitcode.com/GitHub_Trending/mi/MiroFish创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表