lazyvenv

A TUI for managing Python virtual environments.

lazyvenv shows the virtual environments in the current directory, lets you inspect their installed packages (including origin, size, and metadata), and create, delete, activate, and deactivate environments — all from one keyboard- driven interface.

Requirements

• Python 3.13 or newer
• uv — used to list interpreters and create venvs
• zsh, bash, or sh (for the activation shell hook)

Install

uv tool install lazyvenv

This installs the lazyvenv command globally, outside any project venv — which is required for activation to work reliably.

Any isolated installer works, e.g. pipx:

pipx install lazyvenv

Python 3.13 or newer is required, and uv is still needed on your PATH to create venvs.

Shell integration (for activation)

Pressing a inside the app marks a venv to be (de)activated, and the change is applied when you quit. For that to work, add the wrapper function to your shell config:

# ~/.zshrc or ~/.bashrc
eval "$(lazyvenv init zsh)"   # or: lazyvenv init bash

Restart your shell (or source the file). Without this hook the app still works, but a will show a warning instead of activating.

Usage

Run lazyvenv inside any directory containing virtual environments (it scans the directory itself and its immediate children for pyvenv.cfg files):

cd your-project
lazyvenv

Keys

CLI

lazyvenv               Launch the TUI
lazyvenv init [shell]  Print the shell wrapper (zsh, bash, or sh)
lazyvenv --version     Print the version
lazyvenv --help        Show help

Development

git clone https://github.com/Abdulaziz-Hassan/lazyvenv
cd lazyvenv
uv sync
uv run pytest        # tests
uv run ruff check    # lint
uv run ruff format   # format
uv run mypy          # types (strict)
uv run lazyvenv      # run the app

For local development of the global command (e.g. to test the shell hook):

uv tool install --editable .

Changelog

See CHANGELOG.md.

License

MIT