Skip to main content

Fuzzy string matching in python

Project description

Build Status


Fuzzy string matching like a boss. It uses Levenshtein Distance to help calculate differences between sequences in a simple to use package.


  • Python 2.4 or higher

  • difflib

  • python-Levenshtein (optional, provides a 4-10x speedup in String Matching)


Using PIP via PyPI

pip install fuzzywuzzy

Using PIP via Github

pip install git+git://

Adding to your requirements.txt file (run pip install -r requirements.txt afterwards)


Manually via GIT

git clone git:// fuzzywuzzy
cd fuzzywuzzy
python install


>>> from fuzzywuzzy import fuzz
>>> from fuzzywuzzy import process

Simple Ratio

>>> fuzz.ratio("this is a test", "this is a test!")

Partial Ratio

>>> fuzz.partial_ratio("this is a test", "this is a test!")

Token Sort Ratio

>>> fuzz.ratio("fuzzy wuzzy was a bear", "wuzzy fuzzy was a bear")
>>> fuzz.token_sort_ratio("fuzzy wuzzy was a bear", "wuzzy fuzzy was a bear")

Token Set Ratio

>>> fuzz.token_sort_ratio("fuzzy was a bear", "fuzzy fuzzy was a bear")
>>> fuzz.token_set_ratio("fuzzy was a bear", "fuzzy fuzzy was a bear")


>>> choices = ["Atlanta Falcons", "New York Jets", "New York Giants", "Dallas Cowboys"]
>>> process.extract("new york jets", choices, limit=2)
    [('New York Jets', 100), ('New York Giants', 78)]
>>> process.extractOne("cowboys", choices)
    ("Dallas Cowboys", 90)

Known Ports

Some people are porting FuzzyWuzzy to other languages. Here is one port we know about:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fuzzywuzzy-0.8.2.tar.gz (16.8 kB view hashes)

Uploaded source

Built Distribution

fuzzywuzzy-0.8.2-py2-none-any.whl (14.0 kB view hashes)

Uploaded 2 7

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page