DEV Community

Cover image for Forgotten Python environments: Clean Up Disk Fast
Tlaloc-Es
Tlaloc-Es

Posted on

Forgotten Python environments: Clean Up Disk Fast

#python #devops #beginners #programming

Python environments are a common hidden cause of low disk space: .venv/, caches, and build artifacts scale with every repo and experiment.
After a few months, it is easy to accumulate dozens of environments consuming gigabytes—and you only notice when something fails to install or your disk hits 0%.

This guide shows where the storage goes and a safe, inventory-first cleanup workflow across venv/pip/Poetry/conda/uv.

The silent growth nobody monitors

A virtual environment seems small at first, but it multiplies quickly:

  • test project
  • hackathon repo
  • tutorial clone
  • temporary branches
  • PoCs that never got closed

With realistic dependency management (frameworks, data libraries, tooling), each environment can consume hundreds of MB, even GB.

Where the technical junk hides

Not only in .venv/:

  • cached Poetry environments
  • conda environments
  • .tox folders
  • scattered pycache directories
  • dist/build packaging artifacts

This set grows quietly because almost no default workflow cleans it automatically.

Professional cleanup strategy in 4 steps

1) Inventory before deletion

Visibility first, action second.

2) Classify by type and age

Deleting yesterday's environment is not the same as deleting one untouched for 180 days.

3) Clean in safe batches

Start with caches and artifacts. Then move to old environments.

4) Automate maintenance

If you do not automate it, the problem returns.

KillPy as a maintenance component (without turning this into an ad)

After you inventory, the hard part is finding environments scattered across tools and repos and sorting them by age/size. KillPy can scan a path and list candidates before you delete anything.

Practical examples:

# See usage summary
killpy stats --path ~

# List old environments
killpy list --older-than 120

# Simulate cleanup without deleting
killpy delete --type cache --dry-run
Enter fullscreen mode Exit fullscreen mode

For most developers, a monthly pass is enough to keep local environments healthy.

Common mistakes

  1. Deleting before inventory.
  2. Removing an active environment without checking last access.
  3. Cleaning caches while projects are running.
  4. Not versioning lock files, then failing to rebuild environments later.

Prevention best practices

Keep one standard per project

  • use .venv at repo root
  • document official commands
  • avoid ad hoc environments outside the repository

Make dependency management reproducible

  • keep pyproject.toml healthy
  • update lock files whenever dependencies change

CI/CD golden rules

  • build environments from scratch
  • do not reuse residue from previous jobs
  • use explicit commands

Robust example:

python -m venv .venv
.venv/bin/python -m pip install -e ".[dev]"
.venv/bin/python -m pytest
Enter fullscreen mode Exit fullscreen mode

15-minute monthly playbook

  1. Review storage size by environment type.
  2. Remove caches and build artifacts.
  3. Review environments unused for 90+ days.
  4. Confirm active projects rebuild cleanly from lock files.

Follow this playbook and you reduce maintenance friction dramatically.

Final insight

Mastering Python virtual environments does not end when you create .venv/.

Real maturity is closing the full loop:

  • create well
  • maintain well
  • clean well

That is what professional operations look like.

Conclusion

Next time you run out of disk space, do not blame Docker first.

Check your Python environments. You probably have more technical debt in abandoned environments than in the code you wrote this month.

If stale environments keep eating disk space, schedule a periodic inventory + cleanup; KillPy is one option if you want the scan/list step automated.

Top comments (0)