---
id: uuid-extension
version: "0.2.0"
license: unclear
license_treatment: unclear
maintenance: aging
---

# uuid-extension — UUID7 Extension for Python

License: unclear · Maintenance: aging · Downloads: 79.4K/mo

## What it is and what it does

uuid-extension provides a Python implementation of UUID version 7, a time-ordered identifier format. Unlike earlier UUID versions, version 7 encodes a Unix timestamp in its first 48 bits, making the generated IDs naturally sortable by creation time—a property that improves database index performance and query efficiency when UUIDs are used as primary keys or sort keys.

The library wraps the standard Python UUID object and adds methods to extract the embedded timestamp as either a Unix float or a datetime object, optionally in a specific timezone. It also supports an optional counter parameter to guarantee monotonic ordering within the same millisecond, useful in high-frequency ID generation. The package has no runtime dependencies and installs as a pure Python wheel, making it lightweight to adopt.

Use it for:

- Generate sortable primary keys for database tables where insertion order and query performance matter.
- Create time-ordered event IDs in distributed systems where clock synchronization is imperfect.
- Build audit logs or event streams where ID generation timestamp must be recoverable without a separate timestamp column.
- Replace UUID version 4 in applications that benefit from natural time-based ordering without sacrificing uniqueness.
- Implement monotonic ID sequences within millisecond boundaries for high-throughput services.

## Worth the install?

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

Generates UUID version 7 identifiers—time-ordered, RFC-compliant UUIDs that encode a timestamp and support optional monotonic counters for database-friendly ID generation.

Yes, if you need time-ordered UUIDs and can verify the license. The package has zero dependencies, low install friction, and no known vulnerabilities. However, the aging maintenance status (389 days since release, no recent commits visible) and unclear license metadata warrant a quick check before adopting in production—confirm the MIT License claim and assess whether the implementation meets your compliance requirements.

## Install

pip install uuid-extension
uv add uuid-extension
poetry add uuid-extension

## Installing uuid-extension

Before you install: No runtime dependencies and a pure-Python wheel make installation frictionless. The package is aging (389 days since release) with no recent commits visible in the fact sheet, so maintenance activity is unclear.

License in practice: License treatment is unclear—no SPDX identifier or raw license text is recorded. The description mentions MIT License, but this is not confirmed in the metadata, so verify the actual license before adopting in a commercial or copyleft context.

Quickstart:

pip install uuid-extension

from uuid_extension import uuid7

# Generate a new UUID7
uuid = uuid7()
print(uuid)

# Extract timestamp
ts = uuid.to_timestamp()
dt = uuid.to_datetime()

Requires Python 3.8 or later.

Verify before relying:

- Whether the MIT License mentioned in the description is the actual license applied to the package.
- Current maintenance status and whether the package is actively maintained or in maintenance-only mode.
- Whether the UUID version 7 implementation is fully compliant with the specification.
- Performance characteristics and suitability for high-throughput ID generation scenarios.

## Package facts

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

## Tags

UUID version 7 generator, time-ordered UUIDs, sortable unique identifiers, database-friendly UUID generation, timestamp-based UUIDs, monotonic ID generation, UUID with timestamp, uuid-generation, time-ordered-ids, database-optimization

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