orsinium

textdistance: Compare Sequences with 30+ Distance Algorithms

TextDistance is a Python library for comparing two or more sequences with a common interface to 30+ distance and similarity algorithms. It provides pure-Python implementations, with optional external libraries and NumPy for speed.

View on GitHub Compare
Stars
3.5k
Forks
262
Stars, last 30 days
+1
Last commit
1.5 years ago
Contributors
15

Our take

Inactiveno commits in over a year

Health score

23/100

How it is scored
Activity
19
Community
32
Issues
21
Pull requests
20

+1 stars in the last 30 days

TextDistance is a convenient, broad algorithm toolkit, but its inactive status and highly concentrated contribution history make long-term maintenance a material adoption concern.

Good fit if

  • You need a Python interface covering many sequence distance and similarity algorithms.
  • Pure Python is sufficient, or you can install optional external libraries for supported algorithms.
  • You can accept a project with no commits in over a year and no release in over a year, under its MIT license.

Look elsewhere if

  • Your production use depends on active maintenance or recent releases.
  • You need consistently high performance from the pure-Python implementations, which the project cautions can be slow.
  • You need an algorithm or accelerated implementation beyond the documented set of optional integrations.
All health signals
Last commit2025-04-18 (1.5 years ago)
Commits, last 90 days0
Releases, last 12 months0 (latest 4.6.3, 2024-07-16)
Contributors15 (top contributor: 92% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age9 years

Checked on 2026-10-17 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

3,546

Forks

267

Change since Nov 16, 2026: 0 stars·0 forks

Overview

TextDistance is a Python library built on Python for measuring distance or similarity between two or more sequences. It brings more than 30 algorithms behind a common interface, so developers can compare strings or other sequences without adopting a different API for each method.

Its pure-Python implementations make it straightforward to get started, while optional external libraries can accelerate several common algorithms. The project is marked inactive: there have been no commits in over a year and no release in over a year, so teams should weigh its broad algorithm coverage against the maintenance outlook.

Key Features

  • Offers 30+ algorithms, including edit-based, token-based, sequence-based, compression-based, phonetic, and simple comparisons.
  • Provides common methods for distance, similarity, maximum values, and normalized results.
  • Supports comparisons involving more than two sequences.
  • Allows algorithm parameters such as q-gram size and set-based token comparison to be customized.
  • Includes pure-Python implementations and can optionally use external libraries for selected algorithms.
  • Offers optional NumPy usage for speed.

Use Cases

  • A Python developer comparing user-entered names or labels can choose an edit-distance or phonetic algorithm to identify likely matches.
  • A data-cleaning workflow can use token or sequence similarity to find near-duplicate records before review.
  • A team evaluating fuzzy matching approaches can compare multiple algorithms through a consistent API.
  • Researchers or practitioners exploring sequence comparison can use the library's range of algorithms without implementing each one separately.

What you need

Detected in the repository

  • Python (from pyproject.toml)
  • A test suite and automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install the pure-Python package:

pip install textdistance

For optional external libraries, install textdistance[extras]. See the README for algorithm coverage, usage, and other installation options.

Considerations

The measured project status is inactive, with no commits in over a year and no release in over a year. Although the repository has multiple contributors, most of the code comes from one person, and there has been no recent issue or pull-request activity in the measured period. The README's benchmarks warn that pure-Python implementations can be slow; optional external libraries are available for only selected algorithms. Compression-based BZ2, LZMA, and ZLib approaches are described as work in progress. The project uses Python and does not require Docker or a database; the README documents optional dependencies for acceleration, benchmarking, and testing.

Found this useful?

Share it with someone who would like textdistance.

Comparisons