killpy 0.15.7

List all .venv directories and Conda environments 🐍 on your system and check how much space they are using. You can then choose which ones to delete in order to free up space 🧹.

█  ▄ ▄ █ █ ▄▄▄▄  ▄   ▄              ____
█▄▀  ▄ █ █ █   █ █   █           .'`_ o `;__,
█ ▀▄ █ █ █ █▄▄▄▀  ▀▀▀█ .       .'.'` '---'  '
█  █ █ █ █ █     ▄   █  .`-...-'.'Reclaim disk space by cleaning unused Python environments.
           ▀      ▀▀▀    `-...-'

Delete .venv (Virtualenv, Poetry and Conda) Directories

killpy is a simple tool designed to locate and delete .venv directories from your projects, including virtual environments created by Poetry and Conda. It can help you quickly clean up unnecessary virtual environments and save disk space.

Features

• Automatic search: Finds all .venv directories and any folders containing a pyvenv.cfg file recursively from the current working directory, as they are considered virtual environment folders.
• Support for Conda: Lists all available Conda environments.
• Safe deletion: Lists the directories to be deleted and asks for confirmation.
• Fast and lightweight: Minimal dependencies for quick execution.

Installation

To install killpy, use pip:

pip install killpy

Usage

Run the following command to search for .venv directories and any folders containing a pyvenv.cfg file, as well as to list all Conda environments from the current directory and all its subdirectories recursively:

killpy

To scan a different directory instead of the current one:

killpy --path /path/to/project

With pipx

pipx run killpy

pipx run killpy --path /path/to/project

With uvx

uvx killpy

uvx killpy --path /path/to/project

• To close the application, press Ctrl+Q.
• To mark a virtual environment for deletion, press D.
• To confirm deletion of marked virtual environments, press Ctrl+D.
• To delete a virtual environment immediately, press Shift+Delete.
• To clean up __pycache__ folders, press P.

Disclaimer

killpy performs destructive actions (environment/package/cache deletion). By using this tool, you accept full responsibility for any deleted files or unexpected data loss. The killpy team is not responsible for unintended or unexpected deletions.

Pre-Commit

To automatically use KillPy on each commit, you can add a pre-commit hook to your project. This will clean cache directories (like __pycache__) and other unnecessary files before every commit.

- repo: https://github.com/Tlaloc-Es/KillPy
  rev: 0.15.7
  hooks:
    - id: killpy
      pass_filenames: false

Roadmap

• Delete __pycache__ Files
• Remove dist Folders and Build Artifacts
• Clean Up Installed Package Cache
• Delete .egg-info and .dist-info Files
• Analyze and Remove Unused Dependencies
• Optimize Disk Space in Python Projects

Contributing

Contributions are welcome! If you'd like to improve this tool, feel free to fork the repository and submit a pull request.

1. Fork the repository
2. Create a new branch for your feature: git checkout -b my-feature
3. Commit your changes: git commit -m 'Add my feature'
4. Push to the branch: git push origin my-feature
5. Submit a pull request

License

This project is licensed under the MIT License. See the LICENSE file for details.

---

Thank you for using killpy! If you find it useful, please star the repository on GitHub!