venvcleaner 0.1.7

A GUI tool for cleaning up Python virtual environments (venv directories).

Venv Cleaner

A simple GUI tool for cleaning up old or unused Python virtual environments (venv directories).

How to Use

The easiest way to run Venv Cleaner is using uvx:

uvx venvcleaner

You can also specify a target directory:

uvx venvcleaner /path/to/target-directory

If you are using Linux, you will need to build wxPython via pip. Please see Building wxPython for Linux via Pip and wxWidgets for GTK installation.

Alternatively, on some Linux systems, you can use the -f (--find-links) option to specify the download URL of wxPython package:

# for Ubuntu 24.04
uvx -f https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-24.04 venvcleaner

If you want to install to the persistent environment:

uv tool install venvcleaner@latest

# for Ubuntu 24.04
uv tool install -f https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-24.04 venvcleaner@latest

# run Venv Cleaner
venvcleaner

Features

• Scans the target directory for virtual environments (.venv directories containing a pyvenv.cfg file).
• You can change or refresh the target directory with the Select... or Refresh buttons.
• Choose which venvs to clean using the selection list.
  • Select All selects all detected venvs.
  • Select None clears the selection.
• Copy Paths copies the paths of selected venvs to your clipboard. You can paste them into a terminal to run shell commands manually. For example:

ls /path/to/project-1/.venv "/path/to/project 2/.venv"
rm -r /path/to/project-1/.venv "/path/to/project 2/.venv"

• Cleanup Venvs deletes the selected venv directories. Before using this button, you must check the agreement box:

I agree to take responsibility for my actions.

License

This software is distributed under the terms of the MIT License.