Sanjin🤖 MathModelAgent 📐
An agent designed for mathematical modeling
Automatically complete mathematical modeling and generate a ready-to-submit paper.
简体中文 | English
🌟 Vision
Turn 3 days of competition into 1 hour
Automatically generate an award-level 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
- 💰 Low cost agentless (about 1 RMB per task)
🚀 Future Plans
- Add and complete webui, cli
- Comprehensive tutorials and documentation
- Provide 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)
- Multi-language: R, Matlab
- Drawing: napki, draw.io
Video Demo
📖 Usage Guide
Notice: Please make sure Python, Nodejs, and Redis are installed on your computer.
If you want to run the CLI version, switch to the master branch. It's easier to deploy, but will not be updated in the future.
- Configure Model
Copy /backend/.env.dev.example to /backend/.env.dev (remove the .example suffix), and fill in the model configuration and APIKEY
Deepseek Developer Platform
ENV=dev
# Compatible with OpenAI format, refer to official docs
DEEPSEEK_API_KEY=
DEEPSEEK_MODEL=
DEEPSEEK_BASE_URL=
# Max Q&A turns
MAX_CHAT_TURNS=60
# Reflection retries
MAX_RETRIES=5
# https://e2b.dev/
E2B_API_KEY=
LOG_LEVEL=DEBUG
DEBUG=true
# Make sure Redis is installed
REDIS_URL=redis://localhost:6379/0
REDIS_MAX_CONNECTIONS=20
CORS_ALLOW_ORIGINS=http://localhost:5173,http://localhost:3000
It is recommended to use models with strong capabilities and large parameter counts.
- Install Dependencies
Clone the project
git clone https://github.com/jihe520/MathModelAgent.git
Start backend
cd backend
pip install uv # Recommended: use uv to manage python projects
uv sync # Install dependencies
# Start backend
ENV=DEV uvicorn app.main:app --host 0.0.0.0 --port 8000 --ws-ping-interval 60 --ws-ping-timeout 120
Start frontend
cd frontend
pnpm i # Make sure pnpm is installed
pnpm run dev
Results and outputs are generated in the backend/project/work_dir/xxx/* directory:
- notebook.ipynb: code generated during execution
- res.md: final results in markdown format, can be converted to Word (try pandoc)
🤝 Contribution & Development
- The project is in experimental development stage (updated when I have time), with frequent changes and some bugs being fixed.
- Everyone is welcome to participate and make the project better.
- PRs and issues are very welcome.
- For requirements, refer to Future Plans.
After cloning the project, install the Todo Tree plugin to view all todo locations in the code.
.cursor/* contains overall architecture, rules, and mcp for easier development.
📄 License
Free for personal use. For commercial use, please contact me (the author).
🙏 Reference
Thanks to the following projects:
Others
Thanks to sponsors
danmo-tyc
For questions, join the group
QQ Group: 699970403
