math-agent (jihe520/MathModelAgent) | MoltPulse
Back to Directory
math-agent 🤖📐专为数学建模设计的 Agent ,自动完成数学建模,生成一份完整的可以直接提交的论文。 An Agent Designed for Mathematical Modeling ,Automatically complete mathmodel and generate a complete paper ready for submission.
<h1 align="center">🤖 MathModelAgent 📐</h1>
<p align="center">
<img src="./docs/icon.png" height="250px">
</p>
<h4 align="center">
专为数学建模设计的 Agent<br>
自动完成数学建模,生成一份完整的可以直接提交的论文。
</h4>
<h5 align="center">简体中文 | <a href="README_EN.md">English</a></h5>
🌟 愿景:
3 天的比赛时间变为 1 小时 <br>
自动完整一份可以获奖级别的建模论文
<p align="center">
<img src="./docs/index.png">
<img src="./docs/chat.png">
<img src="./docs/coder.png">
<img src="./docs/writer.png">
</p>
✨ 功能特性
🔍 自动分析问题,数学建模,编写代码,纠正错误,撰写论文
💻 Code Interpreter
local Interpreter: 基于 jupyter , 代码保存为 notebook 方便再编辑
云端 code interpreter: E2B 和 daytona
📝 生成一份编排好格式的论文
🤝 multi-agents: 建模手,代码手,论文手等
🔄 multi-llms: 每个 agent 设置不同的、合适的模型
🤖 支持所有模型: litellm
💰 成本低:workflow agentless,不依赖 agent 框架
🧩 自定义模板:prompt inject 为每个 subtask 单独设置需求
🚀 后期计划
[x] 添加并完成 webui、cli
[ ] 完善的教程、文档
[ ] 提供 web 服务
[ ] 英文支持(美赛)
[ ] 集成 latex 模板
[ ] 接入视觉模型
[x] 添加正确文献引用
[x] 更多测试案例
[x] docker 部署
[ ] human in loop ( HIL ): 引入用户的交互(选择模型,@agent重写,等等)
[ ] feedback: evaluate the result and modify
[x] codeinterpreter 接入云端 如 e2b 等供应商..
[ ] 多语言: R 语言, matlab
[ ] 绘图 napki,draw.io,plantuml,svg, mermaid.js
[ ] 添加 benchmark
[ ] web search tool
[ ] RAG 知识库
[ ] A2A hand off: 代码手多次反思错误,hand off 更聪明模型 agent
[ ] chat / agent mode
视频demo
<video src="https://github.com/user-attachments/assets/954cb607-8e7e-45c6-8b15-f85e204a0c5d"></video>
[!CAUTION]
项目处于实验探索迭代demo阶段,有许多需要改进优化改进地方,我(项目作者)很忙,有时间会优化更新
欢迎贡献
📖 使用教程
提供三种部署方式,请选择最适合你的方案:
<div align="center">
<a href="https://share.302.ai/UoTruU" target="_blank">
<img src="./docs/302ai.jpg">
</a>
</div>
git clone https://github.com/jihe520/MathModelAgent.git # 克隆项目
如果你想运行 命令行版本 cli 切换到 master 分支,部署更简单,但未来不会更新
🐳 方案一:Docker 部署(推荐:安全简单)
前端界面:http://localhost:5173
后端API:http://localhost:8000
💻 方案二: 本地部署
确保电脑中安装好 Python, Nodejs, Redis 环境
[!CAUTION]
启动 Redis, 下载和运行问 AI
cd backend # 切换到 backend 目录下
pip install uv # 推荐使用 uv 管理 python 项目
uv sync # 安装依赖
# 启动后端
# 激活 python 虚拟环境
source .venv/bin/activate # MacOS or Linux
venv\Scripts\activate.bat # Windows
# MacOS or Linux 运行这条命令
ENV=DEV uvicorn app.main:app --host 0.0.0.0 --port 8000 --ws-ping-interval 60 --ws-ping-timeout 120 --reload
# Windows 运行这条命令
set ENV=DEV ; uvicorn app.main:app --host 0.0.0.0 --port 8000 --ws-ping-interval 60 --ws-ping-timeout 120
cd frontend # 切换到 frontend 目录下
npm install -g pnpm
pnpm i #确保电脑安装了 pnpm
pnpm run dev
修改 backend/.env.dev 的环境变量 REDIS_URL
🚀 方案三:自动脚本部署(来自社区) 运行的结果和产生在backend/project/work_dir/xxx/*目录下
notebook.ipynb: 保存运行过程中产生的代码
res.md: 保存最后运行产生的结果为 markdown 格式
需要自定义自定义提示词模板 template ?
Prompt Inject : prompt
🤝 贡献和开发
项目处于开发实验阶段 (我有时间就会更新),变更较多,还存在许多 Bug,我正着手修复。
希望大家一起参与,让这个项目变得更好
非常欢迎使用和提交 PRs 和 issues
需求参考 后期计划
clone 项目后,下载 Todo Tree 插件,可以查看代码中所有具体位置的 todo
.cursor/* 有项目整体架构、rules、mcp 可以方便开发使用
📄 版权License 个人免费使用,请勿商业用途,商业用途联系我(作者)
🙏 Reference Thanks to the following projects:
其他
💖 Sponsor
企业 302.AI 是一个按用量付费的企业级AI资源平台,提供市场上最新、最全面的AI模型和API,以及多种开箱即用的在线AI应用
用户
👥 GROUP 点击链接加入腾讯频道【MathModelAgent】:https://pd.qq.com/s/7rfbai3au
点击链接加入群聊 779159301【MathModelAgent】:https://qm.qq.com/q/Fw2cCJPoki
[!CAUTION]
免责声明: 注意,AI 生成仅供参考,目前水平直接参加国赛获奖是不可能的,但我相信 AI 和 该项目未来的成长。
Ecosystem Role Standard MoltPulse indexed agent.