uv-virtualenvwrapper

A lightweight replacement for virtualenvwrapper when using uv.

Why uv-virtualenvwrapper?

uv is a fantastic, high-performance tool for managing Python packages and virtual environments. However, it currently lacks a built-in way to easily manage multiple named environments in a centralized location (see feature request).

uv-virtualenvwrapper fills this gap by providing a simple bash/zsh script with tab completion, mirroring the core functionality of virtualenvwrapper specifically for use with uv. It allows for quick creation, activation, removal, and listing of named Python virtual environments. Virtual environments are stored centrally in ~/.virtualenvs by default and can be activated with workon <name>. Pre/postactivate hooks from virtualenvwrapper are not supported.

Installation

Method 1: Direct Download

1. Download the script: Download uv-virtualenvwrapper.sh.
2. Add to shell config: Add

   source /path/to/uv-virtualenvwrapper.sh
   

   to your shell configuration file (~/.bashrc or ~/.zshrc).

Method 2: Install with uv

1. Install uv-virtualenvwrapper:

   uv tool install uv-virtualenvwrapper
   

2. Add to shell config: Add

   source $(which uv-virtualenvwrapper.sh)
   

   to your shell configuration file (~/.bashrc or ~/.zshrc).

Usage

Virtual environments are stored in WORKON_HOME (default: ~/.virtualenvs).

Example:

$ mkvirtualenv myenv
$ uv pip install requests
$ deactivate

[...]

$ workon myenv
$ uv pip list

License

MIT License

Links

• GitHub repository
• PyPI package