MathModelAgent

一键自动完成数学建模，直接生成可提交的竞赛论文。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 456 🐛 待处理 44 👀 关注 26

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 6303

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源项目，可自行部署使用，无付费版本。

项目预览

项目数据

分类开源模型

开发团队jihe520

官网地址https://mathmodel.top/home

GitHubhttps://github.com/jihe520/MathModelAgent

定价模式🏷️完全免费

价格说明开源项目，可自行部署使用，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

主要语言TeX

技术栈/模型agent,llm,mathmodel,skills

GitHub 星标★ 6303

上线时间2025-01-30 00:00:00

代码更新2026-11-02

仓库体积99.5 MB

本站数据更新2026-11-09

维护状态较活跃

收录时间2026-08-09

浏览次数6

项目介绍

MathModelAgent 是一个专为数学建模竞赛设计的开源智能体项目，旨在自动化完成从问题分析、模型构建到论文生成的全流程。它解决了数学建模过程中耗时长、流程繁琐、论文撰写困难等痛点，通过内置的 Agent 框架和可复用的 skills 模块，自动执行数据探索、模型选择与求解、结果分析，并最终生成一份结构完整、可直接提交的竞赛论文。项目基于 Python 实现，支持多种数学建模常见问题类型，如优化、预测、评价等，并提供了灵活的配置和扩展接口，允许用户自定义模型和论文模板。其核心能力包括自动化建模流程编排、智能体对话式交互、论文自动排版与内容生成，以及丰富的数学工具集成，显著提升建模效率和参赛体验。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 6303

技术标签

agent llm skills

使用教程

难度：入门约 10 分钟部署方式：本地安装 8 步

环境要求

桌面版：无需安装 Python / Node.js / Redis，只需准备一个模型 API Key
Docker 部署：电脑已安装 Docker 环境
本地部署：已安装 Python、Node.js 与 Redis（并设置环境变量 redis_path）
SKILLS / CLI 方式：已安装 Node.js（npx）以及 Claude Code 或 Codex

安装与启动步骤

1下载桌面版安装包

不想折腾环境就选桌面版：从官方 Releases 页面按系统下载，macOS M 系列选 arm64、Intel 选 x64，Windows 选 x64.exe。
2安装并填 API Key

安装包已内置 Claude Code 与全套 SKILLS，无需手动配置 SKILL，装好后填入一个模型 API Key 即可开始建模。
3克隆项目源码

使用 Docker 或本地部署前，先把仓库克隆到本地并进入项目目录。
```
git clone https://github.com/jihe520/MathModelAgent.git
```
4Docker 一键启动

确认本机已装 Docker，在项目文件夹下执行即可同时拉起前后端服务。
```
cd MathModelAgent
docker-compose up
```
5访问界面配 Key

浏览器打开前端 http://localhost:5173，后端 API 为 http://localhost:8000，再到侧边栏 -> 头像 -> API Key 填入密钥。
6启动 Redis 与后端

本地部署先启动 Redis，再用 uvicorn 启动后端；Windows 用户也可直接双击项目中的 win_start.bat。
```
redis-server
uvicorn app.main:app --host 0.0.0.0 --port 8000 --ws-ping-interval 60 --ws-ping-timeout 120 --reload
```
7启动前端界面

进入 frontend 目录用 pnpm 启动前端，并把 backend/.env.dev 里的 REDIS_URL 改成你的 Redis 地址。
```
cd ./frontend/
pnpm run dev
```
8安装 SKILL 走 CLI

开发者可安装 SKILL 后在 Claude Code 或 Codex 中调用 /1start-mathmodel 开始建模，/doctor 可检查环境。
```
npx skills add jihe520/MathModelAgent --all
```

关键配置

配置项	必填	说明	示例
`REDIS_URL`	是	本地部署时 Redis 连接地址，需在 backend/.env.dev 中修改	`redis://localhost:6379/0`
`SEARCH_ENABLED`	否	开启后 Agent 可自主联网搜索真实数据，默认关闭	`true`
`TAVILY_API_KEY`	否	配合 Web Search 使用，到 Tavily 注册获取	`tvly-xxx`
`RAG_ENABLED`	否	开启后从本地知识库检索建模方法和代码模板	`true`
`HIL_ENABLED`	否	开启后在关键节点暂停等待用户审批	`true`