mustel 0.1.3

Simple Python environment inspector + venv manager

mustel 🦦

A simple Python environment inspector + virtual environment manager.

Why?

Ever had this happen?

pip install numpy
import numpy  # ❌ ModuleNotFoundError

That's because you have multiple Python versions, and pip installed it in a different one!

mustel helps you see exactly what's installed where — and manage venvs effortlessly.

Install

pip install mustel

Usage

🔍 Inspect Environments

mustel           # Show packages in current Python
mustel all       # Show all Python installations
mustel diff      # Compare packages across Pythons
mustel check X   # Check if package X exists
mustel updates   # Show outdated packages
mustel --version # Show version

📦 Virtual Environments

mustel venv          # Show venv status dashboard
mustel venv new      # Create a new venv
mustel venv list     # Find all venvs on your system
mustel venv destroy  # Delete venv (with confirmation)

❓ Help

mustel help      # Show help

🛠️ Maintenance

mustel doctor        # Run a health check
mustel clean         # Show cleanable cache files
mustel clean cache   # Clear pip cache
mustel clean pycache # Clear .pyc files

Examples

See all your Pythons

> mustel all

🦦 mustel — all pythons

Found 3 Python(s):

------------------------------------------------------------
★ Python 3.13.11 (current)
  Path: C:\Users\...\Python313\python.exe
  Packages: 11

  Python 3.14.2 
  Path: C:\Users\...\Python314\python.exe
  Packages: 2
------------------------------------------------------------

Use with a specific Python

C:\Python314\python.exe -m mustel

Why "mustel"?

Named after the Mustelidae family (otters, weasels, ferrets) - small but effective hunters that find things in hidden places! 🦦

License

Proprietary - All Rights Reserved.
Copyright © 2026 Ameya Kulkarni, Raunak Nayak

See LICENSE for details.