---
id: coolname
version: "5.0.0"
license: BSD-2-Clause
license_treatment: permissive
maintenance: active
---

# coolname — Random name and slug generator

License: permissive · Maintenance: active · Downloads: 8.9M/mo

## What it is and what it does

Coolname is a pure-Python generator that creates random, human-readable names and URL-safe slugs by combining adjectives, animals, and prepositions. It offers both a simple interface (generate_slug() for ready-to-use strings) and a composable one (generate() for raw word lists you can format yourself). The package supports fixed lengths (2, 3, or 4 words) or random lengths, and includes a command-line tool for one-off generation.

The vocabulary is hand-picked to be neutral or positive, with animals as subjects. It has no external dependencies, works on modern Python versions (3.10+), and is fully customizable—you can define your own word lists and generation rules through a configuration dictionary. The BSD-2-Clause license permits commercial use.

Use it for:

- Generate temporary or memorable project names, test identifiers, or deployment environment names in CI/CD pipelines.
- Create user-friendly URL slugs for REST APIs that need readable, collision-resistant identifiers.
- Build random but pronounceable names for temporary resources (containers, databases, log files) in infrastructure automation.
- Generate placeholder or demo data with human-readable names for testing, prototyping, or documentation examples.
- Produce random team or squad names, challenge names, or event identifiers in gaming or collaborative platforms.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Generates random human-readable names and URL-safe slugs with customizable word combinations, supporting fixed or variable-length output.

Yes. Coolname is a lightweight, stable utility with zero dependencies, active maintenance, no known vulnerabilities, and a permissive license. Install it if you need random readable names or slugs for identifiers, URLs, or test data. The only constraint is Python 3.10+.

## Install

pip install coolname
uv add coolname
poetry add coolname

## Installing coolname

Before you install: Low friction: pure Python with no runtime dependencies, distributed as a wheel. Active maintenance with recent commits and a stable release history since 2015.

License in practice: BSD-2-Clause is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install coolname

from coolname import generate_slug, generate

# Generate a slug
print(generate_slug())
# Output: 'tiny-optimal-crocodile-of-progress'

# Generate a name as a list
print(generate())
# Output: ['beneficial', 'bronze', 'bee', 'of', 'glee']

Requires Python 3.10 or later.

Verify before relying:

- Whether the vocabulary is truly hand-picked and how frequently it is updated.
- Performance characteristics when generating names at scale or in high-concurrency scenarios.
- Whether Django integration is automatic or requires additional configuration.
- The actual number of possible name combinations across different word lengths.

## Package facts

- License: BSD-2-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 8.9M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

random name generator, slug generator, human readable identifiers, random string generator, url safe names, animal name generator, identifier generation, random-generation, slug-friendly, cli-tool

[View on SkillFed](https://skillfed.io/packages/coolname) · [View on PyPI](https://pypi.org/project/coolname/)