uv-virtualenvwrapper 0.1.0

A lightweight virtualenvwrapper replacement for uv

uv-virtualenvwrapper

A lightweight replacement for virtualenvwrapper when using uv.

Provides simple management of named Python virtual environments with tab completion support. Virtual environments are stored in ~/.virtualenvs by default and can be activated with workon myenv anywhere in the filesystem. Only basic functions of virtualenvwrapper are replicated, such as mkvirtualenv, rmvirtualenv, and workon.

Features

• workon: Activate virtual environments with tab completion
• mkvirtualenv: Create new virtual environments using uv venv --seed
• rmvirtualenv: Remove virtual environments
• Bash and zsh shell support
• Follows WORKON_HOME convention (default: ~/.virtualenvs)

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).

Usage

Create a new virtual environment:

mkvirtualenv myenv

which is equivalent to this uv command:

uv venv --seed  ~/.virtualenvs/myenv && source ~/.virtualenvs/myenv/bin/activate

All arguments to mkvirtualenv are passed to uv venv --seed.

Deactivate the virtual environment as usual with:

deactivate

Now you can activate the virtual environment wherever you are in the filesystem with:

workon myenv