Skip to content
Back to search

mathmodelagent

🤖📐专为数学建模设计的 Agent & skills ,自动完成数学建模,生成一份完整的可以直接提交的论文。 An Agent Designed for Mathematical Modeling ,Automatically complete mathmodel and generate a complete paper ready for submission.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jihe520-mathmodelagent/badge.svg)](/listings/jihe520-mathmodelagent)

HTML

<a href="/listings/jihe520-mathmodelagent"><img src="/api/listings/jihe520-mathmodelagent/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

安装 SKILL

npx skills add jihe520/MathModelAgent --all

运行

// claude
claude --dangerously-skip-permissions
claude: /1start-mathmodel 完成这个数学建模任务

// codex
codex --yolo
codex: $start-mathmodel 完成这个数学建模任务

其他命令

/doctor:  检查环境配置
/typst-author: typst 知识

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 493 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <h1 align="center">🤖 MathModelAgent 📐</h1>
  2. <p align="center">
  3. <img src="./docs/icon.png" height="250px">
  4. </p>
  5. <h4 align="center">
  6. 专为数学建模设计的 Agent<br>
  7. 自动完成数学建模,生成一份完整的可以直接提交的论文。
  8. </h4>
  9. <h5 align="center">简体中文 | <a href="README_EN.md">English</a></h5>
  10. <p align="center">
  11. <a href="https://github.com/jihe520/MathModelAgent/releases/latest"><b>⬇️ 下载最新桌面版(推荐)</b></a>
  12. </p>
  13. <p align="center">
  14. 🎨 姊妹项目:<a href="https://github.com/jihe520/sci-box"><b>sci-box</b></a> —— 科研图表 & 流程图 SKILL 合集
  15. </p>
  16. ---
  17. ## 🖥️ 桌面版(推荐使用方式)
  18. > **不想折腾环境?直接下载桌面版,开箱即用。**
  19. >
  20. > 👉 **[前往 Releases 下载最新版本](https://github.com/jihe520/MathModelAgent/releases/latest)**
  21. 桌面版已内置 Claude Code 与全套 MathModelAgent SKILLS,无需安装 Python / Node.js / Redis,也无需手动配置 SKILL,装好填一个模型 API Key 即可开始建模。
  22. | 系统 | 下载文件 |
  23. |------|----------|
  24. | macOS(Apple 芯片 M 系列) | `mathmodel-<version>-arm64.dmg` |
  25. | macOS(Intel 芯片) | `mathmodel-<version>-x64.dmg` |
  26. | Windows 64 位 | `mathmodel-<version>-x64.exe` |
  27. macOS 安装包已 Developer ID 签名并通过 Apple 公证。
  28. > [!TIP]
  29. > 不确定自己的 Mac 是哪种芯片?点击左上角 → 关于本机,看「芯片」一栏:显示 Apple M 系列选 arm64,显示 Intel 选 x64。
  30. > [!WARNING]
  31. > Windows 安装包当前未签名,首次安装或运行时可能出现 Microsoft Defender SmartScreen 提示,请选择「更多信息」→「仍要运行」,并务必从官方 [Releases 页面](https://github.com/jihe520/MathModelAgent/releases/latest) 下载。
  32. 安装后应用会自动检查更新(macOS 支持自动更新,Windows 待代码签名证书配置完成后启用)。
  33. 如果你是开发者,想自行部署或参与贡献,请继续阅读下方的 [SKILLS](#skills) 与 [使用教程](#-使用教程)。
  34. ---
  35. ## 🌟 愿景:
  36. 3 天的比赛时间变为 1 小时
  37. 自动完整一份可以获奖级别的建模论文
  38. <p align="center">
  39. <img src="./docs/chat.png">
  40. <img src="./docs/coder.png">
  41. </p>
  42. ## ✨ 功能特性
  43. - 🔍 自动分析问题,数学建模,编写代码,纠正错误,撰写论文
  44. - 💻 Code Interpreter
  45. - local Interpreter: 基于 jupyter , 代码保存为 notebook 方便再编辑
  46. - 云端 code interpreter: [E2B](https://e2b.dev/) 和 [daytona](https://app.daytona.io/)
  47. - 📝 生成一份编排好格式的论文
  48. - 🤝 multi-agents: 建模手,代码手,论文手等
  49. - 🔄 multi-llms: 每个 agent 设置不同的、合适的模型
  50. - 🤖 支持所有模型: [litellm](https://docs.litellm.ai/docs/providers)
  51. - 💰 成本低:workflow agentless,不依赖 agent 框架
  52. - 🧩 自定义模板:prompt inject 为每个 subtask 单独设置需求
  53. - 🌐 Web Search: Agent 自主搜索互联网获取真实数据(Tavily API)
  54. - 📚 RAG 知识库: 从本地知识库检索建模方法、代码模板、论文写作参考(ChromaDB + Rerank)
  55. - 🤝 HIL 人机协作: 关键节点暂停等待用户审批,支持 6 种决策动作(confirm / edit / regenerate / ask / skip / abort)
  56. - 🛡️ 四层容错: 有限重试 → Fallback Hand Off → Evaluator Shadow Mode → Feedback Rerun
  57. ---
  58. ---
  59. 我在平台中托管了一个在线版本,方便使用,欢迎体验:
  60. https://mathmodel.top/home
  61. ## SKILLS
  62. 项目蒸馏成完全由 SKILLS 驱动
  63. 不再做 Harness 层
  64. ### Intro
  65. MathModelAgent SKILL —— 直接在 Harness 中驱动的数学建模自动化方案.
  66. **💰 开源免费,接入任意模型**
  67. 完全开源免费,可接入任何模型。
  68. **🧠 端到端自动化**
  69. 从问题分析、建模、编码、绘图到论文排版和验收,一条 `/1start-mathmodel` 命令全自动完成,中间阶段自动串联,无需人工干预。
  70. **📄 17 套 Typst 论文模板**
  71. 内置中英文主流赛事模板(国赛、华数杯、华为杯、MCM/ICM 等),自动匹配赛事类型,生成排版精良、可直接提交的 PDF 论文。
  72. **📐 内置建模知识库**
  73. 包含完整的建模规范、模型选择决策树(AHP、TOPSIS、ARIMA、GA 等)、常见易错模式和 MCM/ICM 评分标准,每个阶段自动参考,降低模型幻觉。
  74. **✅ 9 步自动验收**
  75. 文本泄漏检测 → 数值一致性校验 → Typst 编译 → PDF 可视化检查,确保论文零低级错误。
  76. **🔧 可组合、可扩展**
  77. 每个阶段是独立 Skill,可单独调用(如只跑分析、只写论文);模板和知识库可自由扩展;支持 Typst 生态排版。
  78. ### Skills 一览
  79. 工作流 Skills 按 1–6 阶段串联,也可以按需单独调用。
  80. | Skill | 用途 | 主要交付 |
  81. |-------|------|----------|
  82. | [1start-mathmodel](./skills/1start-mathmodel/SKILL.md) | 启动完整数学建模流程,安排各阶段任务 | 建模计划与任务清单 |
  83. | [2analysis-modeling](./skills/2analysis-modeling/SKILL.md) | 分析赛题与数据,设计模型和求解策略 | 建模报告、假设、公式与约束 |
  84. | [3coding-visual](./skills/3coding-visual/SKILL.md) | 编写并运行求解代码,生成数据图表 | 可复现代码、结果报告与图表 PDF |
  85. | [4drawio](./skills/4drawio/SKILL.md) | 绘制技术路线、求解流程与模型结构图 | 可编辑的 DrawIO 图与 PDF |
  86. | [5writing](./skills/5writing/SKILL.md) | 选择比赛模板,组织和排版论文 | Typst / LaTeX 论文源码与 PDF |
  87. | [6verity](./skills/6verity/SKILL.md) | 核对数值、引用、图表、编译与提交要求 | 验收报告与待修复问题 |
  88. | [mathmodel-to-ei](./skills/mathmodel-to-ei/SKILL.md) | 将完整数模论文改写为英文会议论文 | IEEE LaTeX 源码、PDF 与改稿说明 |
  89. | [doctor](./skills/doctor/SKILL.md) | 检查工作流依赖,指导补齐环境 | 环境检查结果与安装指引 |
  90. | [typst-author](./skills/typst-author/SKILL.md) | 编写、修改和排查 Typst 文档 | Typst 源码与排版修复 |
  91. | [mathmodel-figure-templates](./skills/mathmodel-figure-templates/SKILL.md) | 使用内置科研绘图模板,按需调整样式 | 绘图脚本与 PNG / PDF / SVG |
  92. | [_references](./skills/_references/SKILL.md) | 提供各阶段共用的建模、写作与图表规范 | 共享参考知识库,由其他 Skills 按需读取 |
  93. ### 数模论文转 EI 会议论文
  94. 已有完整的数学建模竞赛论文,可以使用 `mathmodel-to-ei` 提炼研究主线、重组章节、改写英文正文并整理图表。内置 IEEE conference LaTeX 模板,交付论文源码、编译成功的 PDF 和改稿说明;目标会议有指定模板时优先使用指定模板。
  95. ```text
  96. 使用 $mathmodel-to-ei,将这篇完整数模论文改写为英文会议论文,交付源码、PDF 和改稿说明。
  97. ```
  98. 下图展示了研赛 2025 A 题论文改写为英文会议初稿的示例,包含论文预览与交付清单。初稿仍需补齐作者信息并确认目标会议要求,不代表已录用或被 EI 收录。
  99. ![数模论文转英文会议论文示例:改稿交付清单与 IEEE 双栏论文预览](./docs/mathmodel-to-ei-demo.png)
  100. ### 🎨 姊妹项目:sci-box(科研图表 & 流程图)
  101. 科研绘图和流程图模板已独立成仓库 **[jihe520/sci-box](https://github.com/jihe520/sci-box)**,可单独安装、单独使用:
  102. | SKILL | 内容 |
  103. |-------|------|
  104. | `scibox-figure` | SHAP / ROC / Taylor / 云雨图 / 和弦图 / 环形热图等科研图表复刻模板(Python + Matplotlib,导出 PNG / PDF / SVG) |
  105. | `scibox-diagram` | 可编辑的 draw.io 模板:五层技术路线图、三栏研究框架、三栏流程图、横向任务流水线 |
  106. ```
  107. npx skills add jihe520/sci-box
  108. ```
  109. ![figure](./docs/figure_templates.png)
  110. ### Install & Usage
  111. 安装 SKILL
  112. ```
  113. npx skills add jihe520/MathModelAgent --all
  114. ```
  115. 运行
  116. ```
  117. // claude
  118. claude --dangerously-skip-permissions
  119. claude: /1start-mathmodel 完成这个数学建模任务
  120. // codex
  121. codex --yolo
  122. codex: $start-mathmodel 完成这个数学建模任务
  123. ```
  124. 其他命令
  125. ```
  126. /doctor: 检查环境配置
  127. /typst-author: typst 知识
  128. ```
  129. ### What Can You Contribute?
  130. 项目以后只会做 SKLLS 层的迭代和优化,不会再做其他部分。
  131. 如果你希望寻找 Agent 开发岗位,你可以研究该项目 Agent 设计并贡献,我会尽量合并.
  132. 你能做什么:
  133. - 优化贡献比赛 typst Template , 你可以找一些 LaTeX 转成 typst
  134. - 优化 SKILL Workflow
  135. - 在不同的 Harness 上测试 不同的 LLM, 提供反馈和案例放在 example 仓库
  136. Harness SKILL 的优化需要大量黑盒测试和调优.
  137. ### Thinking
  138. - 两年前,我做了一个 Mulit-Agent 的数学建模项目并开源出来,收到了社区的欢迎和很多 star, 感谢大家支持。
  139. - 感谢开源的 latex 模板,我在此基础上转化为 typst 模板
  140. - 此 SKILL 是一个基础模板,你可以基于此构建更适合你自己的 MathModel SKILL
  141. - For Agent DEVs : 两年前,我都是自己实现一套 Agent 框架,现在和以后更多的 Agent 产品直接基于 Harness 如 Codex / Claude Code / Pi + SKILLS 来构建
  142. ---
  143. ---
  144. ## 🚀 后期计划
  145. - [x] 添加并完成 webui、cli
  146. - [x] 完善的教程、文档
  147. - [ ] 提供 web 服务
  148. - [ ] 英文支持(美赛)
  149. - [ ] 集成 latex 模板
  150. - [ ] 接入视觉模型
  151. - [x] 添加正确文献引用
  152. - [x] 更多测试案例
  153. - [x] docker 部署
  154. - [ ] human in loop ( HIL ): 关键节点暂停等待用户审批,支持 6 种决策动作(confirm/edit/regenerate/ask/skip/abort)
  155. <!-- TODO: 数据模型已实现,但工作流集成不完整 -->
  156. - [ ] feedback: 评估器评分 + 反馈注入重跑,先 Writer 后 Coder
  157. <!-- TODO: 核心逻辑未实现,仅有 Agent 基类中的 TODO 注释 -->
  158. - [x] codeinterpreter 接入云端 如 e2b 等供应商..
  159. - [ ] 多语言: R 语言, matlab
  160. - [ ] 绘图 napki,draw.io,plantuml,svg, mermaid.js
  161. - [ ] 添加 benchmark
  162. - [ ] web search tool: Tavily API 搜索互联网获取真实数据
  163. <!-- NOTE: 原计划 Tavily API 未实现,当前使用 OpenAlex 替代 -->
  164. - [ ] RAG 知识库: ChromaDB + Rerank 检索建模方法、代码模板、论文写作参考
  165. <!-- TODO: 仅配置项存在,核心检索逻辑未实现 -->
  166. - [ ] A2A hand off: Fallback 自动切换备用模型 + 有限重试 + Evaluator Shadow Mode
  167. <!-- TODO: 配置项和核心逻辑均未实现,仅有基础重试机制 -->
  168. - [ ] chat / agent mode
  169. ## 视频demo
  170. <video src="https://github.com/user-attachments/assets/954cb607-8e7e-45c6-8b15-f85e204a0c5d"></video>
  171. > [!CAUTION]
  172. > 项目处于实验探索迭代demo阶段,有许多需要改进优化改进地方,我(项目作者)很忙,有时间会优化更新
  173. > 欢迎贡献
  174. ## 📖 使用教程
  175. 提供三种部署方式,请选择最适合你的方案:
  176. 1. [docker(最简单)](#-方案一docker-部署推荐最简单)
  177. 2. [本地部署](#-方案二-本地部署)
  178. 3. [脚本本地部署(社区)](#-方案三自动脚本部署来自社区)
  179. 下载项目
  180. ```bash
  181. git clone https://github.com/jihe520/MathModelAgent.git # 克隆项目
  182. ```
  183. > 如果你想运行 命令行版本 cli 切换到 [master](https://github.com/jihe520/MathModelAgent/tree/master) 分支,部署更简单,但未来不会更新
  184. ### 🐳 方案一:Docker 部署(推荐:安全简单)
  185. > 确保电脑安装了 docker 环境
  186. 1. 启动服务
  187. 在项目文件夹下运行:
  188. ```bash
  189. docker-compose up
  190. ```
  191. 2. 访问
  192. 现在你可以访问:
  193. - 前端界面:http://localhost:5173
  194. - 后端API:http://localhost:8000
  195. 3. 配置
  196. 侧边栏 -> 头像 -> API Key
  197. ### 💻 方案二: 本地部署(推荐项目开发者部署)
  198. > 确保电脑中安装好 Python, Nodejs, **Redis** 环境
  199. #### step1:安装依赖
  200. 1. 下载Redis(记得设置环境变量redis_path)
  201. - windows 下载地址:<https://github.com/tporadowski/redis/releases>
  202. - linux or mac 下载地址:<https://redis.io/docs/latest/operate/oss_and_stack/install/install-stack/>
  203. 2. 安装后端依赖
  204. ```bash
  205. # ============ 安装依赖 ============
  206. # 1. 切换到 backend 目录
  207. cd backend
  208. # 2. 安装 uv 包管理器(推荐)
  209. pip install uv
  210. # 3. 同步项目依赖
  211. uv sync
  212. ```
  213. ```bash
  214. # ============ MacOS / Linux 安装命令 ============
  215. # 1. 设置环境变量
  216. export ENV=DEV
  217. export REDIS_URL=redis://localhost:6379/0
  218. ```
  219. ```powershell
  220. # ============ Windows PowerShell 安装命令 ============
  221. # 1. 设置环境变量
  222. $env:ENV="DEV"
  223. $env:REDIS_URL="redis://localhost:6379/0"
  224. # 2. 设置 PowerShell 执行策略策略为 RemoteSigned
  225. Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  226. # 3. 创建虚拟环境
  227. python -m venv venv
  228. ```
  229. 3.安装前端依赖
  230. ```bash
  231. cd frontend # 切换到 frontend 目录下
  232. npm install -g pnpm
  233. pnpm i
  234. ```
  235. #### step2:启动项目
  236. **windows用户直接双击运行项目中的win_start.bat 即可启动项目**
  237. 1.启动 Redis
  238. ```bash
  239. redis-server
  240. ```
  241. 2.启动后端
  242. ```bash
  243. # ============ MacOS / Linux 安装命令 ============
  244. # 1. 激活虚拟环境
  245. source .venv/bin/activate
  246. # 2. 启动后端服务(激活后可直接使用 uvicorn 命令)
  247. uvicorn app.main:app --host 0.0.0.0 --port 8000 --ws-ping-interval 60 --ws-ping-timeout 120 --reload
  248. ```
  249. ```bash
  250. # ============ Windows PowerShell 安装命令 ============
  251. # 1. 切换到 backend 目录
  252. cd .\backend\
  253. # 2. 激活虚拟环境
  254. .\venv\Scripts\Activate.ps1
  255. # 3. 启动后端服务
  256. uvicorn app.main:app --host 0.0.0.0 --port 8000 --ws-ping-interval 60 --ws-ping-timeout 120 --reload
  257. ```
  258. 3.启动前端
  259. ```bash
  260. cd .\frontend\
  261. pnpm run dev
  262. ```
  263. 修改 backend/.env.dev 的环境变量 **REDIS_URL**
  264. 配置API Key
  265. 1. 使用 WebUI
  266.  侧边栏 -> 头像 -> API Key
  267. 2. 修改 backend/.env.dev 文件
  268.  先将.env.example文件 改为.env.dev
  269.  然后在.env.dev中 修改各 Agent API 配置
  270. ### 🚀 方案三:自动脚本部署(来自社区)
  271. 有没有自动部署的脚本 ?
  272. [mmaAutoSetupRun](https://github.com/Fitia-UCAS/mmaAutoSetupRun)
  273. [教程](./docs/md/tutorial.md)
  274. 运行的结果和产生在`backend/project/work_dir/xxx/*`目录下
  275. - notebook.ipynb: 保存运行过程中产生的代码
  276. - res.md: 保存最后运行产生的结果为 markdown 格式
  277. 需要自定义自定义提示词模板 template ?
  278. Prompt Inject : [prompt](./backend/app/config/md_template.toml)
  279. 网络状况太差难以配置Docker等设置?
  280. 网络不畅时的配置过程示例:[网络环境极差时的MathModelAgent配置过程](docs/md/网络环境极差时的MathModelAgent配置过程.md)
  281. ## ⚙️ 新功能配置
  282. MathModelAgent 支持以下可选功能,默认已关闭,开启后未配置外部依赖时自动降级跳过。详见 [升级说明](./升级说明.md)。
  283. | 功能 | 配置开关 | 说明 |
  284. |------|----------|------|
  285. | Web Search | `SEARCH_ENABLED` + `TAVILY_API_KEY` | Agent 自主联网搜索真实数据(Tavily API) |
  286. | RAG 知识库 | `RAG_ENABLED` | 从本地知识库检索建模方法和代码模板(ChromaDB + Rerank) |
  287. | HIL 人机协作 | `HIL_ENABLED` | 关键节点暂停等待用户审批,支持 6 种决策动作 |
  288. | Fallback Hand Off | `FALLBACK_*` 系列 | 主模型故障自动切换备用模型 |
  289. | Evaluator + Feedback | `EVALUATOR_*` 系列 | 输出质量评估 + 反馈重跑 |
  290. 快速启用 Web Search:注册 [Tavily](https://tavily.com) 获取 API Key,在 `backend/.env.dev` 中设置 `TAVILY_API_KEY=tvly-xxx`。
  291. ## 🤝 贡献和开发
  292. [DeepWiki](https://deepwiki.com/jihe520/MathModelAgent) | [Zread](https://zread.ai/jihe520/MathModelAgent)
  293. > [!TIP]
  294. > 如果你有跑出来好的案例可以提交 PR 在该仓库下:
  295. > [MathModelAgent-Example](https://github.com/jihe520/MathModelAgent-Example)
  296. - 项目处于**开发实验阶段**(我有时间就会更新),变更较多,还存在许多 Bug,我正着手修复。
  297. - 希望大家一起参与,让这个项目变得更好
  298. - 非常欢迎使用和提交 **PRs** 和 issues
  299. - 需求参考 后期计划
  300. clone 项目后,下载 **Todo Tree** 插件,可以查看代码中所有具体位置的 todo
  301. `.cursor/*` 有项目整体架构、rules、mcp 可以方便开发使用
  302. ## 📄 版权License
  303. 个人免费使用,请勿商业用途,商业用途联系我(作者)
  304. [License](./docs/md/License.md)
  305. ## 🙏 Reference
  306. Thanks to the following projects:
  307. - [OpenCodeInterpreter](https://github.com/OpenCodeInterpreter/OpenCodeInterpreter/tree/main)
  308. - [TaskWeaver](https://github.com/microsoft/TaskWeaver)
  309. - [Code-Interpreter](https://github.com/MrGreyfun/Local-Code-Interpreter/tree/main)
  310. - [Latex](https://github.com/Veni222987/MathModelingLatexTemplate/tree/main)
  311. - [Agent Laboratory](https://github.com/SamuelSchmidgall/AgentLaboratory)
  312. - [ai-manus](https://github.com/Simpleyyt/ai-manus)
  313. ## 其他
  314. ### 💖 Sponsor
  315. [☕️ 给作者买一杯咖啡](./docs/md/sponser.md)
  316. https://linux.do/
  317. #### 企业
  318. <div align="center">
  319. <a href="https://share.302.ai/UoTruU" target="_blank">
  320. <img src="./docs/302ai.jpg">
  321. </a>
  322. </div>
  323. [302.AI](https://share.302.ai/UoTruU) 是一个按用量付费的企业级AI资源平台,提供市场上最新、最全面的AI模型和API,以及多种开箱即用的在线AI应用
  324. #### 用户
  325. [danmo-tyc](https://github.com/danmo-tyc)
  326. ### 👥 GROUP
  327. 有问题可以进群问
  328. 点击链接加入腾讯频道【MathModelAgent】:https://pd.qq.com/s/7rfbai3au
  329. 点击链接加入群聊 779159301【MathModelAgent】:https://qm.qq.com/q/Fw2cCJPoki
  330. [Discord](https://discord.gg/3Jmpqg5J)
  331. > [!CAUTION]
  332. > 免责声明: 注意,AI 生成仅供参考,目前水平直接参加国赛获奖是不可能的,但我相信 AI 和 该项目未来的成长。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.