Meta

• Author: Robin van der Noord

Classifiers

• Development Status
  • 4 - Beta
• Operating System
  • MacOS
  • POSIX :: Linux
• Programming Language
  • Python :: Implementation :: CPython
  • Python :: Implementation :: PyPy
  • Rust

uvenv: pipx for uv

👁 pypi wheels
👁 snapcraft

Inspired by:

• pipx
• uv

Installation

New: uvenv is now also installable via the snap store.
The pip method is still recommended, but if you want to use snap, please check out docs/snap.md!

1. Install via pip (or alternatives):

   pipinstalluvenv
   # or `uv install uvenv`, `pipx install uvenv`
   

Note: On some systems (e.g., Ubuntu 24.04+), global installation via pip is restricted by default. The recommended way to install uvenv for these systems is to use the install.sh script:

$SHELL-c"$(curl-fsSLhttps://raw.githubusercontent.com/robinvandernoord/uvenv/uvenv/install.sh)"
# instead of `$SHELL`, you can also use `sh`, `bash`, `zsh`
>```
Formoreinstallationalternatives,see[docs/installation.md](docs/installation.md)ifyouencounter`externally-managed-environment`errors.

2. Optional (for bash users):

   uvenvsetup
   

   This installs the following features:

• Ensures ~/.local/bin/ is added to your PATH, so commands can be found (unless --skip-ensurepath). Can also be activated via uvenv ensurepath
• Enables tab completion for uvenv (unless --skip-completions). Can also be enabled via uvenv completions --install.
• Enables uvenv activate (unless --skip-activate) to activate uvenv-managed virtualenvs from your shell

Usage

uvenv

Most pipx commands are supported, such as install, upgrade inject, run, runpip.
Run uvenv without any arguments to see all possible subcommands.

🆕 Freeze and Thaw

You can snapshot your current setup into a uvenv.lock file using:

uvenvfreeze

This lock file records all installed applications along with their metadata — including version, Python version, and any injected dependencies.

Later, you can restore that exact setup using:

uvenvthaw

This is useful for replicating the same setup on a different machine, or after a clean install or system update.

Lock file formats

The uvenv.lock file can be saved in one of the following formats:

• TOML (default): human-readable and easy to edit
• JSON: more verbose, but script-friendly (e.g. with jq)
• Binary: compact, but not human-readable

Choose the format using the --format flag:

uvenvfreeze--formatjson

See docs/lockfile_v1.md for details on the file format, including all supported options and examples.

Selective freeze/thaw

Use --include or --exclude to control which apps get recorded or restored:

uvenvfreeze--excludesome-app
uvenvthaw--includeonly-this-app

For all available options, see:

uvenvfreeze--help
uvenvthaw--help

Migrating from uvx and Comparing with uv tool

Migrating from uvx

The tool previously named uvx is now uvenv due to a naming collision with a new uv command. The new name better reflects its purpose, combining uv with venv. You can run uvenv self migrate to move your environments and installed commands from uvx to uvenv.

---

How uvenv differs from uv tool

While both uvenv and uv tool (a subcommand of uv) offer overlapping functionality for installing and running Python applications, they differ in purpose and approach:

• Interface: uvenv is modeled after pipx, offering commands like install, inject, run, upgrade, and runpip. If you're already used to pipx, uvenv is a near drop-in replacement.
• Inject support: uvenv supports pipx's inject functionality, which lets you add extra packages to an app’s environment — helpful for plugins, linters, or testing tools. uv tool does not currently support this.
• Compatibility: uvenv uses uv for dependency resolution and installation, benefiting from its speed and correctness. It also respects uv's configuration files (such as ~/.config/uv/uv.toml and /etc/uv/uv.toml, see uv config docs) unless the environment variable UV_NO_CONFIG=1 is set to ignore them.

In short:

• Use uvenv if you want pipx-style workflows with advanced management features.
• Use uv tool if you prefer a minimal approach for running tools quickly - for most basic use-cases, uv tool is probably sufficient.

Platform Considerations

• Rust-Powered Performance (uvenv 2.0): Starting from version 2.0, uvenv leverages Rust for improved performance and compatibility with uv.
• Prebuilt Binaries: Currently, prebuilt binaries are available for x86_64 (amd64) and aarch64 (ARM64) on Linux, as well as Intel (x86_64) and Apple Silicon (ARM64) on macOS.
• Other Platforms: If you're on a different platform, you can still use uvx 1.x, which is written in pure Python. Find it at robinvandernoord/uvx.
• Alternatively, you can Compile for Your Platform:
  • Install the Rust toolchain:

    curlhttps://sh.rustup.rs-sSf|sh
    

  • Clone the uvenv repo and navigate to it:

    gitclonehttps://github.com/robinvandernoord/uvenv.git
    cduvenv
    

  • Set up a virtual environment (choose Python or uv):

    python-mvenvvenv# or `uv venv venv --seed`
    sourcevenv/bin/activate
    

  • Install Maturin (Python with Rust package builder):

    pipinstallmaturin# or `uv pip install maturin`
    

  • Compile and install the uvenv binary:

    maturindevelop
    

  • Now you can use uvenv:

    ./venv/bin/uvenv
    

For additional details on building and distribution, refer to maturin documentation.

License

uvenv is distributed under the terms of the MIT license.

Changelog

See CHANGELOG.md on GitHub

Verified details

These details have been verified by PyPI

Maintainers

👁 Avatar for r0bijntje from gravatar.com
r0bijntje 👁 Avatar for remcoboerma from gravatar.com
remcoboerma

Unverified details

These details have not been verified by PyPI

• Download URL: uvenv-3.10.25.tar.gz
• Upload date: Jun 13, 2026
• Size: 107.7 kB
• Tags: Source
• Uploaded using Trusted Publishing? No
• Uploaded via: maturin/1.14.0

Hashes for uvenv-3.10.25.tar.gz

Algorithm	Hash digest
SHA256	796d37503c5fb1a38acd54926e66db164147c6960ed60d3491a8e3c9d909d9a2
MD5	8fa8a1d4700ba134c8224be7a72b1151
BLAKE2b-256	241786c9cdbf6c7618057d16cdfb6f4de4b17fe681673c7daf02d5cba2f68adb

See more details on using hashes here.

• Download URL: uvenv-3.10.25-py3-none-musllinux_1_2_x86_64.whl
• Upload date: Jun 13, 2026
• Size: 7.5 MB
• Tags: Python 3, musllinux: musl 1.2+ x86-64
• Uploaded using Trusted Publishing? No
• Uploaded via: maturin/1.14.0

Hashes for uvenv-3.10.25-py3-none-musllinux_1_2_x86_64.whl

Algorithm	Hash digest
SHA256	f8859e4cbab1e45e7c6eb33bcbf4a43400a3231be8e88584ff0ad5e59c085b84
MD5	89536508a94070e9c48ff2e3f84ad7f1
BLAKE2b-256	4625cfd1988959e86feb30381af9d79fcd807990d701f0bcfdce07c6241e877b

See more details on using hashes here.

• Download URL: uvenv-3.10.25-py3-none-musllinux_1_2_aarch64.whl
• Upload date: Jun 13, 2026
• Size: 7.1 MB
• Tags: Python 3, musllinux: musl 1.2+ ARM64
• Uploaded using Trusted Publishing? No
• Uploaded via: maturin/1.14.0

Hashes for uvenv-3.10.25-py3-none-musllinux_1_2_aarch64.whl

Algorithm	Hash digest
SHA256	d58d86d2b24f2e5ad811e0f7a8d747627f215bb085e172af6f9733ea1021dc38
MD5	77dc173dab2d452200021cbb0cc19e15
BLAKE2b-256	fa33718bd49662d53800098be88dd5eb5d7736e9eed890741b4f5d0b5ec17f70

See more details on using hashes here.

• Download URL: uvenv-3.10.25-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
• Upload date: Jun 13, 2026
• Size: 7.5 MB
• Tags: Python 3, manylinux: glibc 2.17+ x86-64
• Uploaded using Trusted Publishing? No
• Uploaded via: maturin/1.14.0

Hashes for uvenv-3.10.25-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Algorithm	Hash digest
SHA256	6964e3cf505f68cbb12e2887431cbdbb0a231420276857a2fd8b384d8771c525
MD5	7d27ddf0a19db83075a29be7d41c8940
BLAKE2b-256	c751286ac483be7cc2136c504fa81e31c716c315dcd9e1bf634b4bc7717b16bd

See more details on using hashes here.

• Download URL: uvenv-3.10.25-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
• Upload date: Jun 13, 2026
• Size: 7.1 MB
• Tags: Python 3, manylinux: glibc 2.17+ ARM64
• Uploaded using Trusted Publishing? No
• Uploaded via: maturin/1.14.0

Hashes for uvenv-3.10.25-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Algorithm	Hash digest
SHA256	8d57827bffd26d28571fcdc90c1ef35937f3505e479d4b0330d2613cb7e9d4dc
MD5	7416c83b96ead8dc3900b02503282514
BLAKE2b-256	1435a3080fdfbd00add5da3f4c009b09885926f84bce1db71c09969f1b574efe

See more details on using hashes here.

• Download URL: uvenv-3.10.25-py3-none-macosx_11_0_arm64.whl
• Upload date: Jun 13, 2026
• Size: 6.0 MB
• Tags: Python 3, macOS 11.0+ ARM64
• Uploaded using Trusted Publishing? No
• Uploaded via: maturin/1.14.0

Hashes for uvenv-3.10.25-py3-none-macosx_11_0_arm64.whl

Algorithm	Hash digest
SHA256	7f7c2d7b2964d8246ee281add2f052d0b967114b018536c927e08df14d45b098
MD5	1179135028bc06335b0218beee5895a8
BLAKE2b-256	958eadda36f293b9d170591dd9070332f5c0f726e5fd57eab79021c1588f88c4

See more details on using hashes here.