Skip to content

Latest commit

 

History

History
96 lines (66 loc) · 5.35 KB

README.md

File metadata and controls

96 lines (66 loc) · 5.35 KB

gpt-resolve

Can GPT solve Brazilian university entrance exams?

This project is an implementation of how to use LLMs to solve challenging Brazilian university entrance exams.

We'll use o1-preview, which is the best OpenAI model so far with reasoning capabilities, and gpt-4o to describe the exam images so that o1-preview can solve them on question at a time (as it does not have image capabilities yet). Results are saved as txt files with LaTeX formatting, and you can optionally convert them to a nice PDF with this package or using some LaTeX editor.

The project begins with the ITA (Instituto Tecnológico de Aeronáutica) 2025 exam, focusing first on the Math essay section. This section, from the recent exam on November 5, 2024, demands deep subject understanding and step-by-step solutions. More details are in the report documentation.

Spoiler: o1-preview scored 90% in the ITA 2025 Math Essay Exam, 95% in Chemistry Essay and only 65% in Physics Essay.

After the first ITA 2025 exam is fully solved, the project will try to expand to other sections and eventually other exams. Feel free to contribute with ideas and implementations of other exams!

Table of some exams to be solved:

Exam Year Model Status Score Report
ITA 2025 o1-preview 🚧 In Progress - Report
IME 2025 o1-preview 📅 Todo - -
Escola Naval 2025 o1-preview 📅 Todo - -
Fuvest/USP 2025 o1-preview 📅 Todo - -
AFA 2025 o1-preview 📅 Todo - -
UNICAMP 2025 o1-preview 📅 Todo - -
ENEM 2025 o1-preview 📅 Todo - -

Installation and How to use

gpt-resolve is distributed in pypi:

pip install gpt-resolve

gpt-resolve provides a simple CLI with two main commands: resolve for solving exam questions and compile-solutions for generating PDFs from the solutions:

Solve exams with resolve

To generate solutions for an exam:

  • save the exam images in the exam folder exam_path, one question per image file. File names should follow the pattern q<question_number>.jpg, e.g. q1.jpg, q2.jpg, etc.
  • add OPENAI_API_KEY to your global environment variables or to a .env file in the current directory

then, run

gpt-resolve resolve -p exam_path

and grab a coffee while it runs.

If you want to test the process without making real API calls, you can use the --dry-run flag. See gpt-resolve resolve --help for more details about solving only a subset of questions or controlling token usage.

Compile solutions with compile-solutions

Once you have the solutions in your exam folder exam_path, you can compile them into a single PDF running:

gpt-resolve compile-solutions -p exam_path --title "Your Exam Title"

For that command to work, you'll need a LaTeX distribution in your system. See some guidelines here (MacTeX for MacOS was used to start this project).

Troubleshooting

Sometimes, it was observed that the output from o1-preview produced invalid LaTeX code when nesting display math environments (such as \[...\] and \begin{align*} ... \end{align*} together). The current prompt for o1-preview adds an instruction to avoid this, which works most of the time. If that happens, you can try to solve the question again by running gpt-resolve resolve -p exam_path -q <question_number>, or making more adjustments to the prompt, or fixing the output LaTeX code manually.

Costs

The o1-preview model is so far available only for Tiers 3, 4 and 5. It is 6x more expensive than gpt-4o, and also consumes much more tokens to "reason" (see more here), so be mindful about the number of questions you are solving and how many max tokens you're allowing gpt-resolve to use (see gpt-resolve resolve --help to control max-tokens-question-answer, which drives the cost). You can roughly estimate an upper bound for costs of solving an exam by

(number of questions) * (max_tokens_question_answer / 1_000_000) * (price per 1M tokens)

For the current price for o1-preview of $15/$60 per 1M tokens for input/output tokens, an 10 question exam with 10000 max tokens per question would cost less than $6.

Contributing

There are several ways you can contribute to this project:

  • Add solutions for new exams or sections
  • Improve existing solutions or model prompts
  • Add automatic evaluation metrics for answers
  • Create documentations for exams
  • Report issues or suggest improvements

To contribute, simply fork the repository, create a new branch for your changes, and submit a pull request. Please ensure your PR includes:

  • Clear description of the changes
  • Updated table entry (if adding new exam solutions)
  • Any relevant documentation

Feel free to open an issue first to discuss major changes or new ideas!

Sponsors

Buser Logo

This project is proudly sponsored by Buser, Brazil's leading bus travel platform.