IMO25  by lyang36

AI system for solving math olympiad problems

Created 2 months ago
755 stars

Top 46.0% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

This project provides a parallel AI agent system for solving International Mathematical Olympiad (IMO) problems using Google's Gemini API. It's designed for researchers and enthusiasts exploring AI's capabilities in complex problem-solving domains, offering a structured approach to tackle challenging mathematical questions.

How It Works

The system comprises individual AI agents (agent.py) that leverage Google's Gemini 2.5 Pro model to reason through and solve IMO problems. A parallel execution manager (run_parallel.py) orchestrates multiple agents concurrently, increasing the probability of finding a solution. Agents follow a structured reasoning process, with the system identifying successful solutions by detecting specific output phrases.

Quick Start & Requirements

  • Install: pip install requests
  • Prerequisites: Python 3.7+, Google Gemini API key.
  • Setup: Clone the repository, create a .env file with GOOGLE_API_KEY=your_api_key_here or set the environment variable.
  • Usage: python agent.py problem.txt [options] for single agent, python run_parallel.py problem.txt [options] for parallel execution.
  • Documentation: problems folder for problem file format.

Highlighted Details

  • Utilizes Google's Gemini 2.5 Pro model for problem-solving.
  • Supports parallel execution of multiple agents to enhance solution discovery.
  • Allows customization of agent count, timeouts, and additional prompts.
  • Logs detailed reasoning for each agent and provides a summary of parallel runs.

Maintenance & Community

The project is maintained by Lin Yang and Yichen Huang. Contributions via issues, feature requests, or pull requests are welcomed.

Licensing & Compatibility

MIT License. Free to copy, modify, and distribute with attribution. Compatible with commercial and closed-source use.

Limitations & Caveats

Success is dependent on problem difficulty and AI model capabilities; not all problems may be solvable. Users should be mindful of Google API rate limits and associated costs.

Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
6
Star History
205 stars in the last 30 days

Explore Similar Projects

Starred by Tobi Lutke Tobi Lutke(Cofounder of Shopify), Boris Cherny Boris Cherny(Creator of Claude Code; MTS at Anthropic), and
17 more.

marvin by PrefectHQ

0.2%
6k
Python framework for agentic AI workflows
Created 2 years ago
Updated 2 days ago
Starred by Andrew Ng Andrew Ng(Founder of DeepLearning.AI; Cofounder of Coursera; Professor at Stanford), Thomas Wolf Thomas Wolf(Cofounder of Hugging Face), and
4 more.

ag2 by ag2ai

0.9%
4k
AgentOS for building AI agents and facilitating multi-agent cooperation
Created 10 months ago
Updated 2 days ago
Feedback? Help us improve.