Skip to main content

Human readable IDs, in Python

Project description

Human ID test PyPI version

A simple library for generating human IDs like look-dead-game-story or get-nice-office-side.

Install with pip install human-id


from human_id import generate_id

# Simple: "appear-hard-idea-case"

# Custom separator: "do,past,job,number"

# More words: "say-may-ask-traditional-power-week"

# Custom seed - the same UUID will produce the same ID.
import uuid


This module also comes with a small command line tool: humanid-gen

❯ humanid-gen --help
Usage: humanid-gen [OPTIONS]

  Generate human readable IDs

  --words INTEGER  Number of words
  --sep TEXT       Separator
  --seed TEXT      Seed to use
  --count INTEGER  Number of IDs to generate
  --help           Show this message and exit.


This library contains 100 of the most common English nouns, adjectives and verbs, and will generate a phrase containing several of each type, in the order verb, adjective, noun.

The most common words where chosen because they are typically shorter and simpler to read or type, which is a key property of human readable IDs.

By default the ID will contain 4 words, which means there are 300^4 possible IDs (8,100,000,000). If your use case requires more IDs then you can up the number of words at the expense of the readability factor. To have the same number of possible IDs as UUIDs you require 15 words:


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

human_id-0.2.0.tar.gz (4.1 kB view hashes)

Uploaded Source

Built Distribution

human_id-0.2.0-py3-none-any.whl (4.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page