Our take
Inactiveno commits in over a year- Activity
- 19
- Community
- 26
- Issues
- 21
- Pull requests
- 20
-2 stars in the last 30 days
This is a focused, MIT-licensed Hashids library with a clear use case, but its long inactivity and highly concentrated contribution history make maintenance a consideration.
Good fit if
- You need Hashids-style reversible encoding for numeric IDs in a Python application.
- You can use the documented Python compatibility range and, when needed, match the JavaScript implementation version.
- You understand that obscuring an ID does not secure the underlying resource.
Look elsewhere if
- You need a library with recent commits, releases, or demonstrated recent issue handling. The project is marked inactive, with no recent commits or releases and no issues closed in the measured period.
- You need security-grade tokens or access control. The README says Hashids is not intended for security purposes.
- Your team wants evidence of broadly shared maintenance. Most of the code comes from one person.
All health signals
| Last commit | 2023-07-04 (3.3 years ago) |
|---|---|
| Commits, last 90 days | 0 |
| Releases, last 12 months | 0 |
| Contributors | 7 (top contributor: 92% of commits) |
| Issues closed, last 90 days | 0 |
| Pull requests merged, last 90 days | 0 |
| Project age | 13 years |
Checked on 2026-10-29 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,408Forks
104Change since Nov 17, 2026: 0 stars·0 forks
Overview
hashids-python is a Python port of the JavaScript Hashids implementation. It converts one or more numbers into YouTube-like strings that can be used in visible places such as URLs, so applications do not have to expose raw database IDs directly.
The project is aimed at Python applications that need reversible ID obfuscation and compatibility with Hashids in JavaScript. Its README explicitly cautions that the algorithm is not designed or tested for security or compression.
Key Features
- Encodes one or multiple integers as short, reversible strings.
- Decodes generated strings back into tuples of integers.
- Supports a custom salt to vary the output.
- Allows a minimum hash length and custom alphabets of at least 16 characters.
- Documents compatibility between Python versions and releases of the JavaScript implementation.
- Attempts to avoid common English curse words in generated strings.
Use Cases
- A web developer wants shorter, less revealing identifiers in links instead of sequential database IDs.
- A Python service needs to encode several numeric values into one URL-friendly string and recover them later.
- A Python application interoperating with a JavaScript application needs Hashids-compatible encoding, with the relevant implementation versions aligned.
- A product team wants IDs to look less sequential in user-facing URLs, while relying on proper authorization for access control.
What you need
Detected in the repository
- Python >=2.7 (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 from PyPI:
pip install hashids
See the README for encoding examples, configuration, and JavaScript compatibility details.
Considerations
- The repository is inactive, with no commits or releases in the measured recent period. No issues were closed in that period either, so current maintenance and support are uncertain.
- Contribution is concentrated: one contributor accounts for most of the code, despite several contributors overall.
- The README describes the output as obfuscation, not security. Do not use encoded IDs as a substitute for authorization or secure tokens.
- The project documents testing on Python 2.7 and Python 3.5–3.8, while the supplied requirements metadata states Python >=2.7. Confirm compatibility with your target runtime before adopting it.
- It is MIT-licensed; review the repository's license file for applicable terms.
Found this useful?
Share it with someone who would like hashids-python.