jihe520__mathmodelagent/README_EN.md

🤖 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

2. 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.

3. 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:

• OpenCodeInterpreter
• TaskWeaver
• Code-Interpreter
• Latex