un33k

python-slugify: Create Unicode-Aware Slugs in Python

python-slugify turns text into URL-style slugs, with options for transliteration, Unicode retention, and output rules. It suits Python applications that need readable identifiers, especially when teams can manage algorithm and backend changes carefully.

View on GitHub Compare
Stars
1.6k
Forks
146
Stars, last 30 days
+6
Last commit
2 days ago
Contributors
44

Our take

Activeregular commits and releases

Health score

53/100

How it is scored
Activity
55
Community
53
Issues
39
Pull requests
66

+6 stars in the last 30 days

  • Slower to close issues than 90% of the projects we track

This is an actively maintained, established slug-generation library with useful compatibility controls, but its output and dependency choices deserve deliberate review.

Good fit if

  • You need slug generation in Python and can use Python 3.10 or newer.
  • You want configurable transliteration or Unicode retention rather than a one-size-fits-all conversion.
  • You can pin the algorithm and backend when slugs are persisted or exposed as URLs.

Look elsewhere if

  • Your runtime must support Python versions below 3.10 and you need the current release family.
  • You require a dependency-free installation, which this release does not provide.
  • Your project cannot tolerate relying heavily on one contributor, despite the broader contributor base and recent project activity.
All health signals
Last commit2026-10-07 (2 days ago)
Commits, last 90 days27
Releases, last 12 months5 (latest v9.1.3, 2026-10-07)
Contributors44 (top contributor: 77% of commits)
Issues closed, last 90 days7 (typically closed in 199 days)
Pull requests merged, last 90 days14 (typically merged in 0 days)
Project age13 years

Checked on 2026-10-09 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

1,632

Forks

153

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

Overview

python-slugify is a Python library and command-line tool for turning text into normalized, separator-delimited slugs. It handles accented and non-Latin text through selectable transliteration backends, or can retain Unicode characters directly.

It is useful when applications need readable identifiers from user-provided titles or other text. Its legacy algorithm remains the default for compatibility, while a modern algorithm is available as an explicit choice.

Key Features

  • Generate slugs through a Python API or command-line interface.
  • Choose between legacy and modern slug-generation algorithms.
  • Select transliteration backends, or preserve normalized Unicode with allow_unicode=True.
  • Configure separators, filtering patterns, replacements, stopwords, and case handling.
  • Limit output length, with optional word-boundary truncation.
  • Decode HTML entities and numeric character references using configurable options.
  • Keep legacy behavior as the default for applications that depend on existing slug output.

Use Cases

  • Python web developers can generate readable slugs from article titles or product names.
  • Teams maintaining existing URLs can continue using the legacy default while evaluating the modern algorithm separately.
  • Applications handling multiple writing systems can choose a transliteration backend or retain Unicode characters.
  • Developers working with text pipelines can use replacement rules, stopwords, and custom filtering to match their naming conventions.

What you need

Detected in the repository

  • Python >=3.10 (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 package:

python -m pip install --upgrade python-slugify

See the README for algorithm, backend, and command-line options.

Considerations

The project is active, with regular commits and releases, and contributions from dozens of people. However, most of the code contribution share is concentrated in one person. Recent pull requests are merged quickly on median, while issue resolution has taken longer on median, so factor that into expectations for support.

Changing from the legacy algorithm to the modern one can change output. Transliteration backends can also produce different slugs for the same text, so pin both choices before relying on slugs as persistent identifiers. Transliteration is not translation or language-aware pronunciation, and generated slugs are not guaranteed unique or safe for every filesystem or URL context.

The package is MIT licensed, but its optional and base transliteration dependencies have separate license terms. Review the licenses for the actual dependencies and versions you distribute.

Found this useful?

Share it with someone who would like python-slugify.

Comparisons