MathModelAgent Docker部署快速开始：3条命令启动WebUI的完整教程

MathModelAgent Docker部署快速开始3条命令启动WebUI的完整教程【免费下载链接】MathModelAgent专为数学建模设计的 Agent skills ,自动完成数学建模生成一份完整的可以直接提交的论文。 An Agent Designed for Mathematical Modeling ,Automatically complete mathmodel and generate a complete paper ready for submission.项目地址: https://gitcode.com/GitHub_Trending/ma/MathModelAgentMathModelAgent 是一款专为数学建模设计的 AI Agent 工具能自动完成问题分析 → 数学建模 → 代码实现 → 图表生成 → 论文撰写全流程最终产出一份排版精良、可直接提交的建模论文。对于不想手动安装 Python、Node.js、Redis 一堆依赖的新手来说Docker 部署是官方推荐的、也是最简单、最安全的启动方式。本文将带你用 3 条命令完成 MathModelAgent Docker 部署快速在本地浏览器中打开它的 WebUI填上 API Key 就能开始建模。一、部署前先看三个容器与端口速览在动手之前先花 30 秒了解 Docker 会替你跑起哪些服务。整个部署由 docker-compose.yml 编排共启动 3 个容器容器作用端口redis缓存与状态管理6379backendFastAPI 后端Agent 工作流与 API8000frontendWebUI 前端界面Vite5173后端镜像由 backend/Dockerfile 构建基于 Python 3.12已内置中文字体保证 matplotlib 图表中文正常显示前端镜像由 frontend/Dockerfile 构建。你只需要关心一件事浏览器打开http://localhost:5173即可。二、快速开始3 条命令启动 MathModelAgent WebUI✅ 前置条件电脑已安装 Docker含 Docker Compose 插件。命令 1克隆仓库git clone https://gitcode.com/GitHub_Trending/ma/MathModelAgent cd MathModelAgent命令 2启动全部服务docker-compose up -d首次运行会自动构建前后端镜像并拉取 Redis 镜像需要几分钟取决于网速之后重启则会利用缓存速度很快。命令 3检查服务状态docker-compose ps看到redis、backend、frontend三个容器均为Up状态说明部署成功。打开浏览器访问 WebUI 前端界面http://localhost:5173 后端 APIhttp://localhost:8000三、关键一步填写 API Key 配置Docker 只负责把服务跑起来模型 API Key 需要你自己提供。项目内置 4 个协作 Agent——Coordinator协调器、Modeler建模手、Coder代码手、Writer论文手每个 Agent 可独立配置不同的模型。配置方式二选一方式 AWebUI 图形化配置推荐新手侧边栏 → 点击头像 → API Key在弹窗中直接填写即可。方式 B修改环境变量文件将 backend/.env.example 复制为backend/.env.devdocker-compose 会读取该文件为每个 Agent 填写API_KEY/MODEL/BASE_URL。注意模型名建议采用provider/model格式例如COORDINATOR_API_KEYsk-xxx COORDINATOR_MODELgemini/gemini-2.5-flash-preview-04-17 # 使用中转服务时再填写 BASE_URL COORDINATOR_BASE_URLhttps://xxx/v1更多填写细节官方 API 与中转服务写法可参考 docs/md/tutorial.md各配置项的完整含义见 backend/.env.example 中的注释。四、启动后文件都生成在哪里任务运行产生的结果统一保存在backend/project/work_dir/任务目录/下该目录已通过数据卷持久化容器重建不丢失notebook.ipynb建模与求解过程的完整代码可直接用 Jupyter 二次编辑res.md最终论文内容Markdown 格式五、常见问题排查清单问题原因解决方案拉取镜像慢 / 超时网络无法直连 Docker Hub为 Docker 配置国内镜像加速器网络极差时可参考 docs/md/网络环境极差时的MathModelAgent配置过程.md端口被占用本机已占用 8000 / 5173 / 6379修改 docker-compose.yml 中对应的端口映射后重新docker-compose up -d界面打开但无法运行任务未配置模型 API Key按关键一步配置 API Key 后重试日志卡住、报错看不懂——docker-compose logs -f backend实时查看后端日志六、停止服务不需要时一条命令全部停止并清理容器数据卷保留结果不丢docker-compose down写在最后到这里你已完成 MathModelAgent 的完整 Docker 部署3 条命令启动 WebUI一个弹窗填好 API Key就能让 4 个 AI Agent 协作完成数学建模并自动产出论文。如果想深入了解各 Agent 的提示词定制Prompt Inject可以继续查看 backend/app/config/md_template.toml 与 backend/app/config/model_config.toml 两份配置文件。祝建模顺利比赛拿奖【免费下载链接】MathModelAgent专为数学建模设计的 Agent skills ,自动完成数学建模生成一份完整的可以直接提交的论文。 An Agent Designed for Mathematical Modeling ,Automatically complete mathmodel and generate a complete paper ready for submission.项目地址: https://gitcode.com/GitHub_Trending/ma/MathModelAgent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考