---
id: c-uuid-v7
version: "0.0.11"
license: Unlicense
license_treatment: permissive
maintenance: active
---

# c_uuid_v7 — Fast UUID v7 generator implemented as a CPython C extension

License: permissive · Maintenance: active · Downloads: 74.8K/mo

## What it is and what it does

c_uuid_v7 is a Python binding to a C implementation of UUID version 7 generation. UUID v7 is a time-based, sortable identifier format that combines a timestamp with random bits, making it useful for distributed systems and databases where ordering by creation time is valuable. The package provides two interfaces: a fast native mode that returns custom UUID objects, and a compatibility mode that returns standard library uuid.UUID instances (with a performance trade-off) for use in frameworks that expect stdlib types.

The package is implemented as a CPython C extension, which means it compiles to machine code and runs faster than pure-Python alternatives. It supports Python 3.10 through 3.14 and PyPy 3.11, with prebuilt wheels for Linux (multiple architectures), Windows, and macOS, reducing installation friction for most users.

Use it for:

- Generate sortable identifiers for database records in applications where insertion order matters.
- Replace standard UUID generation in ORMs or frameworks that require stdlib uuid.UUID instances but benefit from v7's time-ordering.
- Build distributed systems where multiple services generate IDs independently and need them naturally ordered by creation time.
- High-throughput services that generate many UUIDs per second and need better performance than the standard library.
- Microservices architectures using UUID v7 for correlation IDs or request tracing where performance is critical.

## Worth the install?

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

Generates UUID v7 identifiers via a CPython C extension, offering faster performance than Python's standard library uuid module.

Yes, if you need UUID v7 generation and performance matters. The compiled C extension offers faster execution than pure-Python alternatives, installation is straightforward on common platforms via prebuilt wheels, and the permissive Unlicense poses no legal friction. Install with caution only if you're on an uncommon architecture or Python version outside the 3.10–3.14 range, where you may need to build from source.

## Install

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

## Installing c_uuid_v7

Before you install: Medium install friction due to compiled C extension wheels; however, prebuilt wheels cover common architectures (x86_64, aarch64, armv7l, ppc64le, s390x, riscv64, Windows, macOS) and Python versions 3.10–3.14 plus PyPy 3.11, reducing build-from-source scenarios. Package is actively maintained.

License in practice: Released under the Unlicense, a permissive public-domain-equivalent license with no restrictions on use, modification, or distribution.

Quickstart:

pip install c_uuid_v7

import c_uuid_v7
print(c_uuid_v7.uuid7())  # generates a UUID v7

# For stdlib uuid.UUID compatibility:
import c_uuid_v7.compat as uuid
print(uuid.uuid7())  # returns stdlib uuid.UUID instance

Requires Python 3.10 or later; compiled wheels available for most platforms, but some architectures may require a C compiler.

Verify before relying:

- Whether the performance advantage over stdlib uuid and other UUID v7 libraries justifies the compiled dependency.
- Whether PyPy 3.11 support is complete and performant relative to CPython versions.
- Real-world performance gains in typical application scenarios.

## Package facts

- License: Unlicense (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 74.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

uuid v7 generator, fast uuid generation, uuid7 python, high-performance uuid, sortable uuid, time-based uuid, uuid c extension, uuid-generation, c-extension, performance-critical

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