tox-uv-bare

library1.36.0pypypi✓ verified 26d ago

tox-uv-bare is a plugin for tox that integrates the `uv` dependency manager, allowing tox to leverage `uv`'s speed for virtual environment creation and dependency resolution. This 'bare' package requires users to provide their own `uv` installation. The current version is 1.35.0, and the project has a frequent release cadence, often issuing multiple bug fix and minor feature updates per month.

devops testing

pip install tox-uv-bare

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · TOX-UV-BARE

tox-uv-bare

devopspythonv1.36.0

Install

2.5s avg

Import

—

Disk

29MB

Pass rate

8/ 10

Env Coverage8 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.36.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

glibc

py 3.10

✓ —

✓ 2.75s

py 3.11

✓ —

✓ 2.6s

py 3.12

✓ —

✓ 2.35s

py 3.13

✓ —

✓ 2.3s

py 3.9

1/2 runs

29MB installed

● package 29MB

Code

Verified usage

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

tox_uv

✓ This is a tox plugin, typically enabled via tox.ini. Direct Python imports by end-users are uncommon.

The `tox_uv` module is loaded by tox when `plugins = tox_uv` is specified in tox.ini. Users rarely interact with its Python API directly.

To use tox-uv-bare, you need to enable it as a plugin in your `tox.ini` or `pyproject.toml` file under the `[tox]` section. Remember that `uv` itself must be installed and available in your system's PATH, as this is the 'bare' package. `tox-uv-bare` integrates `uv` for virtual environment creation and dependency installation, but does not provide `uv` as a Python dependency within the created environment.

# tox.ini [tox] requires = tox-uv-bare plugins = tox_uv env_list = py [testenv:py] commands = python -c "import sys; print(f'Python: {sys.version}')" python -c "import uv; print(f'uv is available')" # This command will fail, uv is not imported into the venv directly # To check uv is working, ensure it was used to create the venv and install deps python -c "print('Hello from uv-managed environment!')" # Or a minimal example in pyproject.toml # [tool.tox] # requires = ["tox-uv-bare"] # plugins = ["tox_uv"] # env_list = ["py"] # [testenv:py] # commands = ["python -c \"import sys; print(f'Python: {sys.version}')\""]

Debug

Known issues

gotchaThe `tox-uv-bare` package explicitly requires you to 'bring your own uv'. This means `uv` must be installed separately (e.g., `pip install uv` or via pre-built binaries) and available in your system's PATH. If `uv` is not found, tox will fall back to its default installer, or the environment creation will fail.

fix

Ensure `uv` is installed and accessible in your system's PATH (e.g., `uv --version` should work from your terminal).

affects: All versions

breaking`tox-uv-bare` requires Python 3.10 or newer. Attempting to use it with older Python versions will lead to installation failures or unexpected runtime errors.

fix

Upgrade your Python environment to 3.10 or later where `tox-uv-bare` is installed.

affects: All versions

gotchaChanges to environment variables prefixed with `UV_` (e.g., `UV_EXCLUDE_NEWER`) now correctly invalidate `tox-uv`'s install cache. Prior to version 1.35.0, changes to these variables might not have triggered a cache invalidation, leading to stale environments or unexpected behavior.

fix

Upgrade to `tox-uv-bare` version 1.35.0 or newer to ensure `UV_*` environment variable changes properly invalidate the install cache.

affects: <1.35.0

gotchaFor new projects, consider using the `tox-uv` meta-package instead of `tox-uv-bare`. The `tox-uv` meta-package includes `uv` as a dependency, simplifying installation by not requiring a separate `uv` installation. `tox-uv-bare` is primarily for users who prefer to manage their `uv` installation independently.

fix

For a batteries-included experience, install `tox-uv` (`pip install tox-uv`) instead of `tox-uv-bare`.

affects: All versions

Upgrade

Version history

1.36.0latest on PyPI · released Jul 21, 2026

Audit

Dependencies

toxrequiredCore dependency for the tox plugin system.

Agent activity

12 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/tox-dev/tox-uv ↗

packagehttps://pypi.org/project/tox-uv-bare/ ↗

docshttps://github.com/tox-dev/tox-uv#tox-uv ↗

changeloghttps://github.com/tox-dev/tox-uv/releases ↗