---
id: uuid-v7
version: "1.0.0"
license: unclear
license_treatment: unclear
maintenance: dormant
---

# uuid-v7 — UUID v6 and v7 for Python 3.10+.

License: unclear · Maintenance: dormant · Downloads: 92.2K/mo

## What it is and what it does

uuid_v7 adds UUID v7 and v6 generation to Python's standard uuid module. These are time-based UUID variants that improve on random schemes by providing sortable, timestamp-ordered identifiers suitable for databases and distributed systems. The package is a thin wrapper requiring no external dependencies.

UUID v7 embeds a Unix timestamp, making generated IDs naturally sortable by creation time. UUID v6 reorders fields for the same sortability benefit. Both are useful when you need unique identifiers that also serve as temporal markers without requiring a separate timestamp column or index.

Use it for:

- Generate sortable primary keys for database records where insertion order matters.
- Create time-ordered identifiers for distributed systems without relying on database sequences.
- Implement audit trails or event logs where UUID and timestamp are naturally linked.
- Build APIs that return naturally-ordered resource IDs without explicit sorting overhead.
- Replace random UUID schemes in applications where temporal locality improves performance.

## Worth the install?

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

Generates UUID v7 and v6 identifiers, extending Python's built-in uuid module with time-based and sortable UUID variants.

Yes, if you need UUID v7 or v6 and are on Python 3.10+. The package is lightweight, dependency-free, and solves a real problem. However, verify the license before use in proprietary code, and note that the package is dormant—no updates are expected. Check whether your target Python version has native support before committing to an external dependency.

## Install

pip install uuid-v7
uv add uuid-v7
poetry add uuid-v7

## Installing uuid-v7

Before you install: Low install friction with no runtime dependencies. Package is dormant (no updates since initial release 911 days ago), which may indicate stable maturity or lack of ongoing maintenance.

License in practice: License treatment is unclear; the package metadata does not declare an explicit license. Verify the repository or LICENSE file before use in proprietary or copyleft-sensitive projects.

Quickstart:

pip install uuid_v7

from uuid_v7 import uuidv7, uuidv6

print(uuidv7())
print(uuidv6())

Requires Python 3.10 or later.

Verify before relying:

- Whether the package's license is documented in the repository (metadata shows no SPDX or raw license field).
- Whether dormant status reflects stable maturity or abandonment; no commit or star data available.
- Whether UUID v7 and v6 are natively available in newer Python versions.
- Practical performance characteristics and adoption in production systems.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 92.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

UUID v7 generator, UUID v6 implementation, time-based UUID, sortable UUID, uuid module extension, Python UUID v7, unique identifier generation, uuid-generation, time-ordered-ids

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