← all repositories
jihe520/MathModelAgent

MathModelAgent: an AI team that writes your modeling paper in one hour

A multi-agent pipeline that automates the full math-modeling competition workflow—from problem analysis to code execution to formatted paper generation.

MathModelAgent
Velocity · 7d
+20
★ / day
Trend
accelerating
star history

What it does

MathModelAgent orchestrates specialized LLM agents (modeler, coder, writer) to tackle mathematical modeling problems end-to-end. It analyzes the problem, builds models, writes and executes code via Jupyter or cloud interpreters like E2B and Daytona, then outputs a formatted paper ready for submission. The whole thing is wired together as a custom workflow without heavy agent frameworks, keeping API costs down.

The interesting bit

The project treats a math modeling competition like a small software sprint with human-in-the-loop checkpoints. The author claims the goal is compressing three days of work into one hour—though the README candidly admits current output won’t actually win national competitions yet. The four-layer fault tolerance (retry → fallback → evaluator shadow → feedback rerun) is ambitious on paper, even if much of it remains TODO-stubbed in the codebase.

Key highlights

  • Multi-LLM support via LiteLLM; each agent can use a different model
  • Local Jupyter or cloud code interpreters (E2B, Daytona) with notebook persistence
  • Web search via OpenAlex for real data gathering (Tavily API planned but not implemented)
  • RAG knowledge base scaffolding with ChromaDB + rerank for retrieving modeling methods and templates
  • HIL (human-in-the-loop) with six decision actions at key workflow nodes
  • Docker and local deployment options; WebUI and CLI both available

Caveats

  • Several marquee features are partially or entirely unimplemented: HIL workflow integration, RAG core retrieval logic, fallback hand-off, evaluator feedback loop, and Tavily web search all have TODO comments or placeholder configs
  • The author explicitly warns the project is experimental, buggy, and updated sporadically
  • English support and LaTeX template integration are still pending, limiting use for international competitions like the MCM/ICM

Verdict

Worth a look for Chinese math modeling competitors who want to experiment with AI-assisted workflows and don’t mind rough edges. Skip it if you need production reliability, English output, or a fully realized agent framework—the README is admirably honest about what’s still duct tape and dreams.

Frequently asked

What is jihe520/MathModelAgent?
A multi-agent pipeline that automates the full math-modeling competition workflow—from problem analysis to code execution to formatted paper generation.
Is MathModelAgent open source?
Yes — jihe520/MathModelAgent is an open-source project tracked on heatdrop.
What language is MathModelAgent written in?
jihe520/MathModelAgent is primarily written in Python.
How popular is MathModelAgent?
jihe520/MathModelAgent has 2.9k stars on GitHub and is currently accelerating.
Where can I find MathModelAgent?
jihe520/MathModelAgent is on GitHub at https://github.com/jihe520/MathModelAgent.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.