---
id: pybreaker
version: "1.4.1"
license: unclear
license_treatment: permissive
maintenance: active
---

# pybreaker — Python implementation of the Circuit Breaker pattern

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

## Install

pip install pybreaker
uv add pybreaker
poetry add pybreaker

## Description

PyBreaker
=========

PyBreaker is a Python implementation of the Circuit Breaker pattern, described
in Michael T. Nygard's book `Release It!`_.

In Nygard's words, *"circuit breakers exists to allow one subsystem to fail
without destroying the entire system. This is done by wrapping dangerous
operations (typically integration points) with a component that can circumvent
calls when the system is not healthy"*.


Features
--------

* Configurable list of excluded exceptions (e.g. business exceptions)
* Configurable failure threshold and reset timeout
* Support for several event listeners per circuit breaker
* Can guard generator functions
* Functions and properties for easy monitoring and management
* Thread-safe
* Optional redis backing
* Optional support for asynchronous Tornado calls


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

* `Python`_ 3.9+


Installation
------------

Run the following command line to download the latest stable version of
PyBreaker from `PyPI`_::

    $ pip install pybreaker

If you are a `Git`_ user, you might want to install the current development
version in editable mode::

    $ git clone git://github.com/danielfm/pybreaker.git
    $ cd pybreaker
    $ # run tests...

## AI interpretation — verify before relying

PyBreaker implements the Circuit Breaker pattern to prevent cascading failures by wrapping risky operations and automatically stopping calls when a system becomes unhealthy, with support for configurable thresholds, event listeners, and optional Redis state persistence.

Verdict: PyBreaker is a production-ready, actively maintained library with zero dependencies and a permissive license, making it a low-friction choice for adding circuit breaker resilience to Python applications. No known vulnerabilities and strong community adoption (top 1000 PyPI) support its reliability.

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