2025-04-30 23:20:01 +08:00
2025-03-20 19:21:29 +08:00
2025-04-24 15:29:46 +08:00
2025-04-24 16:00:48 +08:00
2025-04-24 15:29:46 +08:00
2025-02-21 17:58:38 +08:00
2025-03-07 10:47:57 +08:00
2025-03-06 21:22:05 +08:00
2025-03-06 21:22:05 +08:00
2025-04-15 22:14:21 +08:00
2025-03-06 21:22:05 +08:00
2025-03-06 21:22:05 +08:00
2025-02-21 18:36:41 +08:00
2025-04-30 23:20:01 +08:00
2025-03-06 21:22:05 +08:00
2025-03-06 21:22:05 +08:00
2025-03-23 18:35:43 +08:00

🤖 MathModelAgent 📐

An agent designed for mathematical modeling
Automatically complete mathematical modeling and generate a ready-to-submit paper.


简体中文 | English

Vision:

3 days to 1 hour
Automatically generate an award-worthy mathematical modeling paper

✨ Features

  • 🔍 Automatic problem analysis, mathematical modeling, code writing, error correction, and paper writing
  • 💻 Local code interpreter
  • 📝 Generate a well-formatted paper
  • 🤝 Multi-agents: modeling expert, coding expert (reflection module, local code interpreter), paper expert
  • 🔄 Multi-llms: Different models for each agent

🚀 Future Plans

  • Comprehensive tutorials and documentation
  • Web service
  • English support (MCM/ICM)
  • LaTeX template integration
  • Vision model integration
  • Proper citation implementation
  • More test cases
  • Docker deployment
  • User interaction (model selection, rewriting, etc.)
  • Cloud integration for code interpreter (e.g., e2b providers)

After cloning the project, install the Todo Tree plugin to view all specific todo locations in the code

Video Demo

📖 Usage Guide

  1. Install Dependencies
git clone https://github.com/jihe520/MathModelAgent.git
pip install uv
uv venv # create venv
uv sync # install dependencies
  1. Configure Model Copy /config/config.toml.example to /config/config.toml and fill in the model configuration

Recommend using models with strong capabilities and large parameter counts.

  1. Run Tests and Start Project
uv run example.py # simple test to verify correct operation
uv run main.py # complete project

Results will be in the /project/work_dir/ directory

🤝 Contribution

  • Project is in development stage (I update when time permits), with frequent changes and some bugs that I'm working to fix.
  • Issues and PRs are welcome
  • For requirements, refer to Future Plans

📄 License

Not for commercial use. Contact me (author) for commercial purposes.

🙏 Reference

Thanks to the following projects:

S
Description
2analysis-modeling: 数学建模赛题分析与建模设计合并阶段。用于读取题面和附件,完成子问题拆解、数据理解、假设预检、变量定义、模型公式、目标函数、约束条件、求解策略和可交给代码实现的建模报告。; 1start-mathmodel: 数学建模竞赛工作流入口。用于启动完整建模流程:询问用户偏好,生成 plan.md 和 todo.md,并按阶段调用赛题分析、建模、代码与图表、流程图、论文撰写、验证验收等 skills。; 4drawio: 数学建模非数据型图示绘制阶段。根据 ANALYSIS_MODELING_REPORT.md、RESULTS_REPORT.md 和已有 figures/ 生成技术路线图、子问题求解流程图、模型结构图、数据处理流程图等 DrawIO 图,并导出论文可引用 PDF。; 5writing: 数学建模竞赛论文撰写阶段,支持 Typst 和 LaTeX 双引擎。根据 ANALYSIS_MODELING_REPORT.md、RESULTS_REPORT.md 和 figures/*.pdf 选择比赛模板、排版引擎、组织章节,并在论文正文中按章节直接…
Readme 103 MiB
Languages
Python 37.2%
Vue 21.2%
TeX 19.8%
Typst 13.2%
TypeScript 5.5%
Other 3%