Install uvenv

  1. Welcome
  2. License agreement
  3. Shell features
  4. Ready to install
  5. Example output
  6. Try it

Step 1 of 6

Welcome to uvenv

This guide shows the commands to install uvenv. You run them in your own terminal.

uvenv installs Python command-line apps the way pipx does: each app gets its own virtual environment, and uv resolves and installs the packages. uvenv itself is a single binary written in Rust.

Install uvenv with:
pip install uvenv

uvenv Help

Click a book to open it, then click a topic.

    What uvenv is

    uvenv installs Python command-line apps, such as black, httpie or pgcli, in separate virtual environments with their own dependencies, isolated from your system Python. Their commands are linked into ~/.local/bin, so you run them like any other program.

    uvenv has the commands you know from pipx, including install, inject, run and upgrade. It uses uv to resolve and install packages, and uvenv itself is a single binary written in Rust.

    uvenv reads uv's configuration files (~/.config/uv/uv.toml and /etc/uv/uv.toml) for settings such as package indexes. Set UV_NO_CONFIG=1 to ignore them.