---
id: deepdiff6
version: "6.2.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# deepdiff6 — Deep Difference and Search of any Python object/data. Recreate objects by adding adding deltas to each other.

License: permissive · Maintenance: active · Downloads: 278.2K/mo

## What it is and what it does

DeepDiff is a library for detecting structural differences between Python objects at any depth. It recursively traverses dictionaries, lists, and other iterables to report all changes—additions, removals, and value modifications—with detailed path information. The package includes two companion tools: DeepSearch for locating objects within nested structures, and DeepHash for generating content-based hashes of arbitrary Python objects.

The library is commonly used in testing, data validation, configuration comparison, and debugging. It supports flexible comparison modes (ignoring order, excluding types or paths, using regex patterns, handling floating-point precision) and offers both text and tree views of results. A command-line interface is available via the [cli] extra, exposing diff, patch, grep, and extract commands.

Use it for:

- Unit testing: assert that two complex data structures are identical or detect specific changes between versions
- Configuration validation: compare expected vs. actual configuration objects to identify mismatches
- API response testing: verify that JSON responses match expected schemas, ignoring order when appropriate
- Data migration auditing: track what changed when transforming or updating nested data structures
- Debugging: quickly identify which fields or nested values differ between two object states

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

DeepDiff recursively compares two Python objects—dictionaries, lists, strings, and other types—to identify all differences, and provides companion tools for searching within objects and hashing based on content.

Yes. DeepDiff is a mature, well-maintained library (active status, recent commits, 2520 stars) with permissive MIT licensing, low install friction, and no known vulnerabilities. It solves a common problem—deep object comparison—with a flexible API and multiple output views. Suitable for testing, validation, and debugging workflows.

## Install

pip install deepdiff6
uv add deepdiff6
poetry add deepdiff6

## Installing deepdiff6

Before you install: Low install friction; single runtime dependency (ordered-set). Active maintenance with recent commits and 2520 repository stars. Tested on Python 3.7+ and PyPy3.

License in practice: MIT license (permissive); you may use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install deepdiff6

from deepdiff import DeepDiff
t1 = {1: 1, 2: 2, 3: 3}
t2 = {1: 1, 2: 4, 3: 3}
ddiff = DeepDiff(t1, t2)
print(ddiff)

Verify before relying:

- Whether the package is still published under 'deepdiff6' on PyPI or has reverted to 'deepdiff' name post-v6
- Current status of the CLI extras (deepdiff6[cli]) and whether all documented commands are functional

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 278.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

deep object comparison, recursive diff dictionaries, find differences in nested data, object equality testing, deep search in objects, content-based hashing, testing, data-comparison, debugging

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