---
id: vcrpy
version: "8.3.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# vcrpy — Automatically mock your HTTP interactions to simplify and speed up testing

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

## Install

pip install vcrpy
uv add vcrpy
poetry add vcrpy

## Description

###########
VCR.py 📼
###########


|PyPI| |Python versions| |Build Status| |CodeCov| |Gitter|

----

.. image:: https://vcrpy.readthedocs.io/en/latest/_images/vcr.svg
   :alt: vcr.py logo


This is a Python version of `Ruby's VCR
library <https://github.com/vcr/vcr>`__.

Source code
  https://github.com/kevin1024/vcrpy

Documentation
  https://vcrpy.readthedocs.io/

Rationale
---------

VCR.py simplifies and speeds up tests that make HTTP requests. The
first time you run code that is inside a VCR.py context manager or
decorated function, VCR.py records all HTTP interactions that take
place through the libraries it supports and serializes and writes them
to a flat file (in yaml format by default). This flat file is called a
cassette. When the relevant piece of code is executed again, VCR.py
will read the serialized requests and responses from the
aforementioned cassette file, and intercept any HTTP requests that it
recognizes from the original test run and return the responses that
corresponded to those requests. This means that the requests will not
actually result in HTTP traffic, which confers several benefits
including:

-  The ability to work offline
-  Completely...

## AI interpretation — verify before relying

VCR.py records and replays HTTP interactions for tests, allowing you to run deterministic offline tests by capturing real HTTP exchanges into YAML cassette files and replaying them on subsequent runs.

Verdict: vcrpy is a mature, actively maintained testing utility (Production/Stable, top 1000 PyPI) with permissive MIT licensing, minimal dependencies, and zero known vulnerabilities. It is a low-friction choice for teams needing deterministic HTTP testing.

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