Our take
Activeregular commits and releases- 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 commit | 2026-10-07 (2 days ago) |
|---|---|
| Commits, last 90 days | 27 |
| Releases, last 12 months | 5 (latest v9.1.3, 2026-10-07) |
| Contributors | 44 (top contributor: 77% of commits) |
| Issues closed, last 90 days | 7 (typically closed in 199 days) |
| Pull requests merged, last 90 days | 14 (typically merged in 0 days) |
| Project age | 13 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.
Stars
1,632Forks
153Change 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.