---
id: pytest-rerunfailures
version: "16.5"
license: MPL-2.0
license_treatment: copyleft
maintenance: active
---

# pytest-rerunfailures — pytest plugin to re-run tests to eliminate flaky failures

License: copyleft · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install pytest-rerunfailures
uv add pytest-rerunfailures
poetry add pytest-rerunfailures

## Description

.. contents::

pytest-rerunfailures
====================

.. START-SHORT-DESCRIPTION

pytest-rerunfailures is a plugin for `pytest <https://pytest.org>`_ that
re-runs tests to eliminate intermittent failures.

.. END-SHORT-DESCRIPTION

.. image:: https://img.shields.io/badge/license-MPL%202.0-blue.svg
   :target: https://github.com/pytest-dev/pytest-rerunfailures/blob/master/LICENSE
   :alt: License
.. image:: https://img.shields.io/pypi/v/pytest-rerunfailures.svg
   :target: https://pypi.python.org/pypi/pytest-rerunfailures/
   :alt: PyPI
.. image:: https://github.com/pytest-dev/pytest-rerunfailures/workflows/Test/badge.svg
   :target: https://github.com/pytest-dev/pytest-rerunfailures/actions
   :alt: GitHub Actions
.. image:: https://readthedocs.org/projects/pytest-rerunfailures/badge/?version=latest
    :target: https://pytest-rerunfailures.readthedocs.io/latest/?badge=latest
    :alt: Documentation Status

.. START-INSTALLATION

Requirements
------------

You will need the following prerequisites in order to use pytest-rerunfailures:

- Python 3.10+ or PyPy3
- pytest 8.2 or newer

This plugin can recover from a hard crash with the following optional
prerequisites:

-...

## AI interpretation — verify before relying

A pytest plugin that automatically re-runs failed tests to eliminate intermittent flaky failures, with support for delays, backoff strategies, and selective exception filtering.

Verdict: A well-maintained, production-stable pytest plugin for handling flaky tests with minimal dependencies and no known vulnerabilities. MPL-2.0 copyleft licensing is straightforward for most projects. Suitable for teams dealing with intermittent test failures.

[View on SkillFed](https://skillfed.io/packages/pytest-rerunfailures) · [View on PyPI](https://pypi.org/project/pytest-rerunfailures/)