davidaurelio

hashids-python: Turn Numbers into Shareable Hashes

hashids-python is a Python port of the JavaScript Hashids implementation, creating YouTube-like strings from one or more numbers. Use it to make database IDs less exposed in URLs, not as a security mechanism.

View on GitHub Compare
Stars
1.4k
Forks
103
Stars, last 30 days
-2
Last commit
3.3 years ago
Contributors
7

Our take

Inactiveno commits in over a year

Health score

22/100

How it is scored
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 commit2023-07-04 (3.3 years ago)
Commits, last 90 days0
Releases, last 12 months0
Contributors7 (top contributor: 92% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age13 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.

Selected snapshot

Stars

1,408

Forks

104

Change 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.

Comparisons