https://github.com/hnimminh/human-readable-id
The human readable id generator library for python3
https://github.com/hnimminh/human-readable-id
human identity name naming uuid uuid-generator
Last synced: 3 months ago
JSON representation
The human readable id generator library for python3
- Host: GitHub
- URL: https://github.com/hnimminh/human-readable-id
- Owner: hnimminh
- License: mit
- Created: 2020-12-25T09:51:26.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-10-19T15:01:46.000Z (8 months ago)
- Last Synced: 2026-01-02T12:26:59.881Z (6 months ago)
- Topics: human, identity, name, naming, uuid, uuid-generator
- Language: Python
- Homepage:
- Size: 67.4 KB
- Stars: 17
- Watchers: 0
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/hnimminh/human-readable-id)
HRID: Human Readable Identifier
The Human Readable ID Generator Library For Python3
## Usage
Install
```
pip3 install hrid
```
Use in Python code
```python
from hrid import HRID
hruuid = HRID()
uuid = hruuid.generate()
print(uuid)
```
## Why HRID?
* Comparing to UUID, hrid is extremely easy to remember, that why this package named `human readable`, example `red-bird-fly-crazily` versus `206dbaab-526b-41cd-aa6f-7febd82e83ab`.
* Over 800 billion alphabet hrid can be generated by default (or many more if include more factor to format). In the other hand, with a large numbers of ids, This library has a very slim chance of collision.
* Customizable structure for uuid, eg {`adjective`}{`noun`} or {`number`}{`adjective`}{`noun`}{`verb`}{`adverd`} or add whatever you want `prefix`, `postfix`
## Credit
* [Dictionary Source](https://github.com/dariusk/corpora)
* [Inspired by Google API Design](https://cloud.google.com/blog/products/gcp/api-design-choosing-between-names-and-identifiers-in-urls)
## License
[MIT](./LICENSE)