Python desktop utility

PyCleaner

Python Virtual Environment Control Center

Scan your projects, identify real venv and .venv folders, review their sizes, and reclaim disk space from one polished native desktop interface. No Flask server. No browser shell. No pip dependency parade.

Download Source Package View Build Guide

Includes the Python source file, documentation, and artwork required to create your own standalone build with PyInstaller.

PyCleaner 2.0 application interface and feature overview

Dependency-FreeBuilt with Python and Tkinter.

Verified TargetsChecks for real virtual environments.

Local by DesignNo uploads, tracking, or browser server.

PyInstaller ReadyPackage your own standalone executable.

Find. Review. Clean.

Virtual environment cleanup without the command-line archaeology.

PyCleaner turns a repetitive filesystem chore into a visual, controlled workflow where every discovered environment can be inspected before anything is removed.

⌕

Manual or Automatic Scanning

Choose a specific project tree or scan the current user’s home folder for every directory named venv or .venv.

✓

Verified Environments

PyCleaner identifies genuine Python environments by checking for pyvenv.cfg instead of blindly trusting folder names.

Optional Size Reports

Calculate individual environment sizes and see the total amount of disk space that can be reclaimed before selecting anything.

↕

Clickable Results

Select checkbox cells, sort columns, filter results, invert selections, open project folders, or operate entirely from the keyboard.

⚙

Responsive Background Work

Scanning and deletion run away from the main interface thread, keeping the application responsive while larger project trees are processed.

⌫

Deliberate Cleanup

Deletion is limited to selected folders whose final name is exactly venv or .venv, with explicit confirmation required.

Source distribution

Build the executable for your own system.

This release is intentionally distributed as Python source rather than a precompiled binary. The download includes the application, documentation, and artwork needed for a local PyInstaller build.

Important: PyInstaller itself is a build dependency, not an application runtime dependency. Once packaged, the resulting executable can be distributed separately according to the options used for your build.

# Install the build tool
python3 -m pip install pyinstaller

# Build a single-file GUI executable
pyinstaller --onefile PyCleaner.py

# Result
dist/PyCleaner

Guardrails engaged

Cleanup with brakes, mirrors, and a very loud confirmation step.

Deletion is permanent, so PyCleaner puts review and verification ahead of speed.

✓Symlinks are never followed or deleted.

✓Automatic scans skip common cache and vendor trees.

✓Only folders ending exactly in venv or .venv are eligible.

✓Permanent deletion requires confirmation and typing DELETE.

Runtime requirements

Small footprint. Familiar machinery.

Run the source directly with Python 3.8 or newer and Tkinter.

# Linux / macOS
python3 PyCleaner.py

# Windows
python PyCleaner.py

# Ubuntu / Debian, when Tkinter is absent
sudo apt install python3-tk

Bring order to the venv jungle.

Download PyCleaner 2.0, review the included documentation, run the source directly, or compile a standalone build tailored to your platform.

Download PyCleaner 2.0