nox-uv

library0.8.0pypypi✓ verified 83d ago

Nox-UV facilitates the integration of `uv`, a fast Python package installer and resolver, into `nox` sessions. It streamlines dependency management and session setup for testing, linting, and other development tasks, leveraging `uv`'s performance benefits. The current version is 0.7.1, and the library maintains an active development pace with frequent updates.

testing devops

pip install nox-uv

github ↗package ↗

INSTALL

IMPORT

SIG · NOX-UV

nox-uv

testingpythonv0.8.0

Install

2.8s avg

Import

—

Disk

31MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.8.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.920 runs

installs and imports cleanly · install 0.0s · import 0.000s · 32.4MB

glibc

py 3.10–3.920 runs

installs and imports cleanly · install 2.8s · import 0.000s · 33MB

31MB installed

● package 31MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

session

✓ from nox_uv import session

✗ from nox_uv import uvsession

Create a `noxfile.py` in your project root. The `uvsession` decorator replaces `nox.session` and automatically uses `uv` for package management within the session. The `session.install` command will then utilize `uv`.

import nox from nox_uv import uvsession @uvsession(python=["3.9", "3.10", "3.11", "3.12"]) def test(session: uvsession): # Installs project and test dependencies using uv session.install("-e", ".[test]") session.run("pytest", *session.posargs) @uvsession(python="3.12") def lint(session: uvsession): # Installs ruff using uv session.install("ruff") session.run("ruff", "check", ".") session.run("ruff", "format", "--check", ".")

Debug

Known issues

gotchaThe `uv` executable must be installed and accessible in the system's PATH or within the Nox virtual environment. `nox-uv` is a bridge, not a `uv` installer.

fix

Install `uv` globally (`pip install uv` or `cargo install uv`) or ensure it's part of your base Nox environment setup.

affects: All

breakingHandling of project `extras` changed significantly in v0.3.0 (removed arbitrary extras) and was refined in v0.7.0 (allowing exclusion of specific groups). Old `session.install` calls might behave differently.

fix

Review your `session.install` calls involving `extras` (e.g., `.[dev,test]`). Consult the documentation for the correct syntax for your `nox-uv` version, especially regarding exclusions.

affects: 0.3.0, 0.7.0

gotchaFrom v0.7.1, a `uv_quiet` option was added to suppress `uv sync` output for cleaner logs. If you're missing this option, you're on an older version.

fix

Upgrade to `nox-uv` v0.7.1 or higher to use the `uv_quiet=True` option in your `@uvsession` decorator.

affects: <0.7.1

gotchaFor scenarios where the current project should *not* be installed into the session's environment, use `uv_no_project_install=True`.

fix

If upgrading to v0.6.0 or later, consider adding `uv_no_project_install=True` to your `@uvsession` decorator if your `session.install(".")` or `session.install("-e", ".")` calls are unintentional for that session.

affects: <0.6.0

Upgrade

Version history

0.8.0latest on PyPI · released May 12, 2026

Audit

Dependencies

noxrequiredCore testing automation tool that nox-uv extends.

uvrequiredThe underlying package installer and resolver nox-uv integrates with. Must be available in the environment.

Agent activity

12 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/dantebben/nox-uv ↗

packagehttps://pypi.org/project/nox-uv/ ↗