Overview
EvalPlus is an evaluation framework for code-generation language models. It extends the well-known HumanEval and MBPP benchmarks with many more test cases: HumanEval+ adds about 80x more tests and MBPP+ about 35x more, so models that pass the originals but break on edge cases are caught.
It is meant for LLM researchers and engineering teams who train or compare code models and want a trustworthy pass@1 number. By measuring how much a score drops once the extra tests are applied, EvalPlus shows whether a model's generated code is solid or fragile. It also includes EvalPerf, which scores the efficiency of generated code, not just its correctness.
As a benchmark harness, it packages datasets, a CLI, a Docker image, and a public leaderboard. One command can run generation, post-processing, and evaluation, and it supports several inference backends including vLLM, Google Gemini, and Anthropic.
What it does
- HumanEval+ and MBPP+ datasets with far more tests than the originals to expose edge-case failures
- EvalPerf benchmark that measures the runtime efficiency of generated code, not only correctness
- Single command runs generation, post-processing, and evaluation end to end
- Multiple inference backends, including vLLM, Google Gemini, and Anthropic
- Safe code execution inside the provided Docker image (ganler/evalplus)
- Public leaderboard with model rankings before and after the stricter tests
Getting started
Install the package from PyPI, then run a model against HumanEval or MBPP with a single command. Use the Docker image when you want isolated, safe execution of generated code.
Install EvalPlus
Install the latest stable release from PyPI. Use the vllm extra if you plan to run a model with the vLLM backend.
pip install "evalplus[vllm]" --upgradeRun correctness evaluation
Generate samples and evaluate them on HumanEval or MBPP in one command. Pick the dataset and backend, and add --greedy for deterministic decoding.
evalplus.evaluate --model "ise-uiuc/Magicoder-S-DS-6.7B" \
--dataset humaneval \
--backend vllm \
--greedyRun generation and evaluation separately
Generate code locally first, then evaluate the resulting samples inside Docker for safe execution.
evalplus.codegen --model "ise-uiuc/Magicoder-S-DS-6.7B" \
--dataset humaneval \
--backend vllm \
--greedyCommands and code are distilled from the project's own documentation — always check the official repo for the latest.
When to use it
- Benchmarking a newly trained code model on HumanEval+ and MBPP+ to report a reliable pass@1 score
- Comparing several code-generation models on the same stricter test suite before publishing results
- Checking how much a model's score drops under the extra tests to judge whether its code is fragile
- Measuring the runtime efficiency of generated code with EvalPerf alongside correctness
How EvalPlus compares
EvalPlus alongside other open-source benchmark harnesses tools AI/TLDR tracks, ranked by GitHub stars.
| Tool | Stars | What it does |
|---|---|---|
| LM Evaluation Harness | ★ 14k | EleutherAI's framework for few-shot evaluation of language models across 60+ academic benchmarks, used as the backend for many leaderboards. |
| OpenCompass | ★ 7.5k | An LLM evaluation platform that runs models against 100+ datasets covering reasoning, knowledge, coding, and domain tasks, with leaderboards and multi-model support. |
| SWE-bench | ★ 5.9k | A benchmark and containerized harness that tests whether language models can resolve real GitHub issues by generating patches that pass a repository's tests. |
| simple-evals | ★ 4.6k | OpenAI's lightweight library for running standard zero-shot, chain-of-thought benchmarks like MMLU, MATH, and GPQA to measure model accuracy. |
| lmms-eval | ★ 4.4k | An evaluation suite for large multimodal models that runs image, video, and audio benchmarks across many tasks with a unified, reproducible interface. |
| AgentBench | ★ 3.7k | A benchmark that evaluates LLMs as agents across diverse interactive environments such as operating systems, databases, web browsing, and games. |
| HELM | ★ 2.9k | Stanford CRFM's Holistic Evaluation of Language Models framework for reproducible, transparent benchmarking of foundation and multimodal models across many scenarios and metrics. |
| EvalPlus | ★ 1.8k | Rigorous correctness and efficiency benchmarks for code-generation LLMs |
