---
id: fuzzywuzzy
version: "0.18.0"
license: GPLv2
license_treatment: copyleft
maintenance: abandoned
---

# fuzzywuzzy — Fuzzy string matching in python

License: copyleft · Maintenance: abandoned · Downloads: 15.8M/mo

## What it is and what it does

FuzzyWuzzy is a string-matching library that calculates similarity scores between text sequences using Levenshtein distance. It offers multiple matching strategies—simple ratio, partial ratio, token sort, and token set—each suited to different comparison scenarios. The library includes a process module for batch operations like extracting the best matches from a list of candidates.

The package has no runtime dependencies and installs cleanly. However, it is archived and abandoned as of February 2023, with the last release in 2020. While the core algorithm is stable and unlikely to break, you should not expect bug fixes, security patches, or compatibility updates for future Python versions. An optional C extension (python-Levenshtein) can provide a 4-10x performance boost but may produce different results in edge cases.

Use it for:

- Deduplicate or merge user-entered names and addresses that may contain typos or formatting variations
- Search for songs or files by approximate title match when exact names are unknown or misspelled
- Match product names across databases with inconsistent naming conventions or abbreviations
- Implement autocomplete or suggestion features that tolerate user spelling mistakes
- Link records from different data sources where identifiers don't match exactly

## Worth the install?

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

FuzzyWuzzy performs fuzzy string matching using Levenshtein distance to find approximate matches between text sequences, with optional speedup via an external C library.

Yes, for read-only string matching in stable applications. The algorithm is mature and well-tested, install friction is minimal, and no known vulnerabilities exist. However, do not adopt it for new projects requiring active maintenance or Python version support beyond 3.6. The GPLv2 license is a hard blocker for proprietary software. For actively maintained alternatives, look elsewhere.

## Install

pip install fuzzywuzzy
uv add fuzzywuzzy
poetry add fuzzywuzzy

## Installing fuzzywuzzy

Before you install: Installation is straightforward with no runtime dependencies. The package is archived and unmaintained since February 2023, with the last release in 2020, so no active bug fixes or compatibility updates should be expected.

License in practice: Licensed under GPLv2 (copyleft), which requires that any derivative work or linked application also be open-source under a compatible license—a significant constraint for proprietary software.

Quickstart:

pip install fuzzywuzzy

from fuzzywuzzy import fuzz
fuzz.ratio("this is a test", "this is a test!")

Verify before relying:

- Whether the package works reliably on Python versions beyond 3.6 (classifiers list only up to 3.6)
- Current compatibility with modern Python versions given the 2023 abandonment
- Whether difflib alone is sufficient or if python-Levenshtein is required for acceptable performance

## Package facts

- License: GPLv2 (copyleft)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 15.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

fuzzy string matching, approximate string comparison, levenshtein distance, typo-tolerant search, string similarity scoring, partial text matching, token-based string matching, string-matching, abandoned, copyleft-license

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