# venvy - Python Virtual Environment Manager
**The smartest way to manage Python virtual environments**
[](https://pypi.org/project/venvy/)
[](https://pypi.org/project/venvy/)
[](https://pepy.tech/project/venvy)
[](https://opensource.org/licenses/MIT)
## What is venvy?
**venvy** is an intelligent command-line tool that automatically discovers, analyzes, and manages Python virtual environments across your entire system. Stop manually hunting for forgotten environments, wondering which ones are safe to delete, or struggling with disk space issues.
### Key Features
- **🔍 Smart Discovery** - Automatically finds all Python environments (venv, conda, pyenv, virtualenv)
- **📊 Intelligent Analysis** - Shows usage patterns, disk space, health status, and cleanup suggestions
- **🧹 Safe Cleanup** - Remove unused environments with confidence using AI-powered recommendations
- **💾 Space Management** - Identify space hogs and duplicate environments
- **🏥 Health Monitoring** - Detect broken, outdated, or corrupted environments
- **🎨 Beautiful Interface** - Rich terminal output with tables, progress bars, and colors
- **⚡ Cross-Platform** - Works seamlessly on Windows, macOS, and Linux
## Installation
```bash
pip install venvy
```
That's it! No complex setup, no configuration files needed.
## Quick Start
```bash
# List all virtual environments
venvy list
# Show disk usage analysis
venvy size
# Get intelligent cleanup suggestions
venvy suggest
# Remove unused environments safely
venvy clean --unused 90
# Get detailed info about an environment
venvy info myproject-env
```
## Why Choose venvy?
### Problem: Virtual Environment Chaos
- Forgotten environments scattered across your system
- Gigabytes of disk space wasted on unused environments
- No easy way to identify which environments are safe to remove
- Broken environments that cause mysterious errors
- Time wasted manually hunting for environment locations
### Solution: Intelligent Management
venvy solves these problems with smart automation:
```bash
$ venvy list
Environment Type Python Size Health Last Used
project1-venv venv 3.9.7 245 MB Healthy 2 days ago
old-django-project venv 3.8.0 1.2 GB Broken 4 months ago
data-science conda 3.10.2 892 MB Healthy 1 week ago
temp-test venv 3.9.7 156 MB Outdated 6 months ago
$ venvy suggest
Cleanup Suggestions:
Environment Reason Space Risk Confidence
old-django-project Broken and unused for 120 days 1.2 GB Low 95%
temp-test Unused for 180 days 156 MB Low 87%
Potential space savings: 1.4 GB
```
## Core Commands
### Environment Discovery
```bash
venvy list # List all environments
venvy list --type conda # Filter by type (venv, conda, pyenv)
venvy list --sort size # Sort by size, age, or usage
venvy list --format json # Machine-readable output
```
### Space Analysis
```bash
venvy size # Show environments by size
venvy size --top 5 # Show 5 largest environments
venvy duplicates # Find similar environments
```
### Health & Maintenance
```bash
venvy health # Overall health report
venvy doctor myenv # Deep health check for specific environment
venvy stats # System-wide statistics
```
### Smart Cleanup
```bash
venvy suggest # Get cleanup recommendations
venvy clean --unused 30 # Remove environments unused for 30+ days
venvy clean --dry-run # Preview what would be removed
venvy remove myenv # Remove specific environment
```
## Advanced Features
### Intelligent Analysis
venvy doesn't just list environments - it provides insights:
- **Usage Tracking**: Knows which environments you actually use
- **Health Monitoring**: Detects broken Python executables, missing dependencies
- **Space Optimization**: Identifies duplicate packages and cache bloat
- **Project Association**: Links environments to their projects automatically
- **Security Scanning**: Finds environments with outdated packages
### Safe Operations
Every destructive operation includes safety measures:
- **Automatic Backups**: Creates backups before removal
- **Confidence Scoring**: AI-powered risk assessment for cleanup suggestions
- **Dry Run Mode**: Preview changes before applying them
- **Confirmation Prompts**: Prevents accidental deletions
### Professional Output
Beautiful, informative displays that work great in terminals and CI/CD:
- **Rich Tables**: Sortable columns with color-coded health indicators
- **Progress Bars**: Visual feedback for long operations
- **JSON Export**: Perfect for scripting and automation
- **Cross-Platform**: Consistent experience across operating systems
## Use Cases
### For Individual Developers
- **Clean up development machine**: Remove old project environments safely
- **Disk space management**: Identify and remove space-wasting environments
- **Environment health**: Find and fix broken development environments
- **Project organization**: See which environments belong to which projects
### For Development Teams
- **Standardize environment management**: Consistent cleanup policies across team
- **CI/CD integration**: Automated environment cleanup in build pipelines
- **Onboarding**: Help new developers clean up their development setup
- **Documentation**: Generate environment inventory reports
### For System Administrators
- **Server maintenance**: Clean up unused environments on shared development servers
- **Disk space monitoring**: Proactive identification of space usage issues
- **Environment auditing**: Security and compliance reporting
- **Automated cleanup**: Scheduled cleanup of unused environments
## Technical Details
### Supported Environment Types
- **venv** - Python 3.3+ built-in virtual environments
- **virtualenv** - Traditional virtual environment tool
- **conda** - Anaconda/Miniconda environments
- **pyenv** - Python version management environments
### Detection Methods
- **Smart Scanning**: Looks in common locations (`~/venvs`, `~/.virtualenvs`, etc.)
- **Configuration Files**: Reads `pyvenv.cfg`, `conda-meta/`, `.python-version`
- **Custom Paths**: Supports user-defined search locations
- **Symbolic Link Resolution**: Handles complex directory structures
### Performance Optimizations
- **Parallel Processing**: Multi-threaded environment scanning
- **Smart Caching**: Avoids re-analyzing unchanged environments
- **Lazy Loading**: Only analyzes environments when needed
- **Memory Efficient**: Minimal memory footprint even with hundreds of environments
### Safety Features
- **Backup Creation**: Automatic backups before destructive operations
- **Permission Handling**: Graceful handling of permission-denied scenarios
- **Error Recovery**: Robust error handling and reporting
- **Verification**: Confirms successful operations
## Configuration
venvy works perfectly out-of-the-box, but can be customized:
```bash
# Add custom search paths
venvy config --add-path ~/my-projects/envs
# Set default cleanup threshold
venvy config --set default-unused-days 60
# Configure output format
venvy config --set output-format table
```
Configuration is stored in your system's standard config directory and syncs across sessions.
## Python Virtual Environment Management Best Practices
venvy embodies Python virtual environment best practices:
1. **Regular Cleanup**: Remove unused environments to free disk space
2. **Health Monitoring**: Keep environments updated and functional
3. **Organization**: Maintain clear project-environment associations
4. **Documentation**: Know what environments you have and why
5. **Automation**: Use tools like venvy instead of manual management
## FAQ
**Q: Is it safe to use venvy to delete environments?**
A: Yes! venvy creates automatic backups and uses confidence scoring to ensure safe cleanup recommendations.
**Q: Will venvy work with my existing environments?**
A: Absolutely. venvy works with all standard Python environment tools and doesn't modify your existing setup.
**Q: Can I use venvy in scripts or CI/CD?**
A: Yes! venvy supports JSON output, quiet modes, and non-interactive operation perfect for automation.
**Q: Does venvy require admin/root privileges?**
A: No. venvy only needs access to your user directories and respects file permissions.
## Contributing
We welcome contributions! venvy is open source and community-driven.
- **Bug Reports**: [GitHub Issues](https://github.com/pranavkumaarofficial/venvy/issues)
- **Feature Requests**: [GitHub Discussions](https://github.com/pranavkumaarofficial/venvy/discussions)
- **Code Contributions**: [Pull Requests](https://github.com/pranavkumaarofficial/venvy/pulls)
## License
MIT License - see [LICENSE](LICENSE) file for details.
## Keywords
Python virtual environment manager, venv cleanup, conda environment management, Python development tools, disk space cleanup, environment health monitoring, Python project management, development workflow optimization, virtual environment discovery, Python environment analysis
---
**Made with ❤️ by [Pranav Kumaar](https://github.com/pranavkumaarofficial)**
*venvy - Because managing Python virtual environments should be intelligent, not manual.*
Raw data
{
"_id": null,
"home_page": null,
"name": "venvy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "python, virtual-environment, venv, conda, environment-management",
"author": "Pranav Kumaar",
"author_email": null,
"download_url": null,
"platform": null,
"description": "# venvy - Python Virtual Environment Manager\r\n\r\n**The smartest way to manage Python virtual environments**\r\n\r\n[](https://pypi.org/project/venvy/)\r\n[](https://pypi.org/project/venvy/)\r\n[](https://pepy.tech/project/venvy)\r\n[](https://opensource.org/licenses/MIT)\r\n\r\n## What is venvy?\r\n\r\n**venvy** is an intelligent command-line tool that automatically discovers, analyzes, and manages Python virtual environments across your entire system. Stop manually hunting for forgotten environments, wondering which ones are safe to delete, or struggling with disk space issues.\r\n\r\n### Key Features\r\n\r\n- **\ud83d\udd0d Smart Discovery** - Automatically finds all Python environments (venv, conda, pyenv, virtualenv)\r\n- **\ud83d\udcca Intelligent Analysis** - Shows usage patterns, disk space, health status, and cleanup suggestions \r\n- **\ud83e\uddf9 Safe Cleanup** - Remove unused environments with confidence using AI-powered recommendations\r\n- **\ud83d\udcbe Space Management** - Identify space hogs and duplicate environments\r\n- **\ud83c\udfe5 Health Monitoring** - Detect broken, outdated, or corrupted environments\r\n- **\ud83c\udfa8 Beautiful Interface** - Rich terminal output with tables, progress bars, and colors\r\n- **\u26a1 Cross-Platform** - Works seamlessly on Windows, macOS, and Linux\r\n\r\n## Installation\r\n\r\n```bash\r\npip install venvy\r\n```\r\n\r\nThat's it! No complex setup, no configuration files needed.\r\n\r\n## Quick Start\r\n\r\n```bash\r\n# List all virtual environments\r\nvenvy list\r\n\r\n# Show disk usage analysis \r\nvenvy size\r\n\r\n# Get intelligent cleanup suggestions\r\nvenvy suggest\r\n\r\n# Remove unused environments safely\r\nvenvy clean --unused 90\r\n\r\n# Get detailed info about an environment\r\nvenvy info myproject-env\r\n```\r\n\r\n## Why Choose venvy?\r\n\r\n### Problem: Virtual Environment Chaos\r\n- Forgotten environments scattered across your system\r\n- Gigabytes of disk space wasted on unused environments\r\n- No easy way to identify which environments are safe to remove\r\n- Broken environments that cause mysterious errors\r\n- Time wasted manually hunting for environment locations\r\n\r\n### Solution: Intelligent Management\r\nvenvy solves these problems with smart automation:\r\n\r\n```bash\r\n$ venvy list\r\nEnvironment Type Python Size Health Last Used \r\nproject1-venv venv 3.9.7 245 MB Healthy 2 days ago \r\nold-django-project venv 3.8.0 1.2 GB Broken 4 months ago \r\ndata-science conda 3.10.2 892 MB Healthy 1 week ago \r\ntemp-test venv 3.9.7 156 MB Outdated 6 months ago \r\n\r\n$ venvy suggest\r\nCleanup Suggestions:\r\nEnvironment Reason Space Risk Confidence\r\nold-django-project Broken and unused for 120 days 1.2 GB Low 95%\r\ntemp-test Unused for 180 days 156 MB Low 87%\r\n\r\nPotential space savings: 1.4 GB\r\n```\r\n\r\n## Core Commands\r\n\r\n### Environment Discovery\r\n```bash\r\nvenvy list # List all environments\r\nvenvy list --type conda # Filter by type (venv, conda, pyenv) \r\nvenvy list --sort size # Sort by size, age, or usage\r\nvenvy list --format json # Machine-readable output\r\n```\r\n\r\n### Space Analysis\r\n```bash\r\nvenvy size # Show environments by size\r\nvenvy size --top 5 # Show 5 largest environments\r\nvenvy duplicates # Find similar environments\r\n```\r\n\r\n### Health & Maintenance\r\n```bash\r\nvenvy health # Overall health report\r\nvenvy doctor myenv # Deep health check for specific environment\r\nvenvy stats # System-wide statistics\r\n```\r\n\r\n### Smart Cleanup\r\n```bash\r\nvenvy suggest # Get cleanup recommendations\r\nvenvy clean --unused 30 # Remove environments unused for 30+ days\r\nvenvy clean --dry-run # Preview what would be removed\r\nvenvy remove myenv # Remove specific environment\r\n```\r\n\r\n## Advanced Features\r\n\r\n### Intelligent Analysis\r\nvenvy doesn't just list environments - it provides insights:\r\n\r\n- **Usage Tracking**: Knows which environments you actually use\r\n- **Health Monitoring**: Detects broken Python executables, missing dependencies\r\n- **Space Optimization**: Identifies duplicate packages and cache bloat \r\n- **Project Association**: Links environments to their projects automatically\r\n- **Security Scanning**: Finds environments with outdated packages\r\n\r\n### Safe Operations\r\nEvery destructive operation includes safety measures:\r\n\r\n- **Automatic Backups**: Creates backups before removal\r\n- **Confidence Scoring**: AI-powered risk assessment for cleanup suggestions\r\n- **Dry Run Mode**: Preview changes before applying them\r\n- **Confirmation Prompts**: Prevents accidental deletions\r\n\r\n### Professional Output\r\nBeautiful, informative displays that work great in terminals and CI/CD:\r\n\r\n- **Rich Tables**: Sortable columns with color-coded health indicators\r\n- **Progress Bars**: Visual feedback for long operations\r\n- **JSON Export**: Perfect for scripting and automation\r\n- **Cross-Platform**: Consistent experience across operating systems\r\n\r\n## Use Cases\r\n\r\n### For Individual Developers\r\n- **Clean up development machine**: Remove old project environments safely\r\n- **Disk space management**: Identify and remove space-wasting environments\r\n- **Environment health**: Find and fix broken development environments\r\n- **Project organization**: See which environments belong to which projects\r\n\r\n### For Development Teams \r\n- **Standardize environment management**: Consistent cleanup policies across team\r\n- **CI/CD integration**: Automated environment cleanup in build pipelines\r\n- **Onboarding**: Help new developers clean up their development setup\r\n- **Documentation**: Generate environment inventory reports\r\n\r\n### For System Administrators\r\n- **Server maintenance**: Clean up unused environments on shared development servers\r\n- **Disk space monitoring**: Proactive identification of space usage issues\r\n- **Environment auditing**: Security and compliance reporting\r\n- **Automated cleanup**: Scheduled cleanup of unused environments\r\n\r\n## Technical Details\r\n\r\n### Supported Environment Types\r\n- **venv** - Python 3.3+ built-in virtual environments\r\n- **virtualenv** - Traditional virtual environment tool\r\n- **conda** - Anaconda/Miniconda environments\r\n- **pyenv** - Python version management environments\r\n\r\n### Detection Methods\r\n- **Smart Scanning**: Looks in common locations (`~/venvs`, `~/.virtualenvs`, etc.)\r\n- **Configuration Files**: Reads `pyvenv.cfg`, `conda-meta/`, `.python-version`\r\n- **Custom Paths**: Supports user-defined search locations\r\n- **Symbolic Link Resolution**: Handles complex directory structures\r\n\r\n### Performance Optimizations\r\n- **Parallel Processing**: Multi-threaded environment scanning\r\n- **Smart Caching**: Avoids re-analyzing unchanged environments \r\n- **Lazy Loading**: Only analyzes environments when needed\r\n- **Memory Efficient**: Minimal memory footprint even with hundreds of environments\r\n\r\n### Safety Features\r\n- **Backup Creation**: Automatic backups before destructive operations\r\n- **Permission Handling**: Graceful handling of permission-denied scenarios\r\n- **Error Recovery**: Robust error handling and reporting\r\n- **Verification**: Confirms successful operations\r\n\r\n## Configuration\r\n\r\nvenvy works perfectly out-of-the-box, but can be customized:\r\n\r\n```bash\r\n# Add custom search paths\r\nvenvy config --add-path ~/my-projects/envs\r\n\r\n# Set default cleanup threshold\r\nvenvy config --set default-unused-days 60\r\n\r\n# Configure output format\r\nvenvy config --set output-format table\r\n```\r\n\r\nConfiguration is stored in your system's standard config directory and syncs across sessions.\r\n\r\n## Python Virtual Environment Management Best Practices\r\n\r\nvenvy embodies Python virtual environment best practices:\r\n\r\n1. **Regular Cleanup**: Remove unused environments to free disk space\r\n2. **Health Monitoring**: Keep environments updated and functional\r\n3. **Organization**: Maintain clear project-environment associations\r\n4. **Documentation**: Know what environments you have and why\r\n5. **Automation**: Use tools like venvy instead of manual management\r\n\r\n## FAQ\r\n\r\n**Q: Is it safe to use venvy to delete environments?** \r\nA: Yes! venvy creates automatic backups and uses confidence scoring to ensure safe cleanup recommendations.\r\n\r\n**Q: Will venvy work with my existing environments?** \r\nA: Absolutely. venvy works with all standard Python environment tools and doesn't modify your existing setup.\r\n\r\n**Q: Can I use venvy in scripts or CI/CD?** \r\nA: Yes! venvy supports JSON output, quiet modes, and non-interactive operation perfect for automation.\r\n\r\n**Q: Does venvy require admin/root privileges?** \r\nA: No. venvy only needs access to your user directories and respects file permissions.\r\n\r\n## Contributing\r\n\r\nWe welcome contributions! venvy is open source and community-driven.\r\n\r\n- **Bug Reports**: [GitHub Issues](https://github.com/pranavkumaarofficial/venvy/issues)\r\n- **Feature Requests**: [GitHub Discussions](https://github.com/pranavkumaarofficial/venvy/discussions)\r\n- **Code Contributions**: [Pull Requests](https://github.com/pranavkumaarofficial/venvy/pulls)\r\n\r\n## License\r\n\r\nMIT License - see [LICENSE](LICENSE) file for details.\r\n\r\n## Keywords\r\n\r\nPython virtual environment manager, venv cleanup, conda environment management, Python development tools, disk space cleanup, environment health monitoring, Python project management, development workflow optimization, virtual environment discovery, Python environment analysis\r\n\r\n---\r\n\r\n**Made with \u2764\ufe0f by [Pranav Kumaar](https://github.com/pranavkumaarofficial)**\r\n\r\n*venvy - Because managing Python virtual environments should be intelligent, not manual.*\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Intelligent Python virtual environment manager",
"version": "0.1.0",
"project_urls": {
"Documentation": "https://github.com/pranavkumaarofficial/venvy#readme",
"Homepage": "https://github.com/pranavkumaarofficial/venvy",
"Issues": "https://github.com/pranavkumaarofficial/venvy/issues",
"Repository": "https://github.com/pranavkumaarofficial/venvy"
},
"split_keywords": [
"python",
" virtual-environment",
" venv",
" conda",
" environment-management"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "04fe8c8ac01c7573e40699e84cf1f3ee19eb775fabe38044ef680d3122f9f0c7",
"md5": "72526acab3a913bb0861472289840917",
"sha256": "f3372417cc0271ce2506af21b1a4393c563fbd28bdc39af46ab6d4796665cb54"
},
"downloads": -1,
"filename": "venvy-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "72526acab3a913bb0861472289840917",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 34110,
"upload_time": "2025-09-03T17:08:09",
"upload_time_iso_8601": "2025-09-03T17:08:09.851237Z",
"url": "https://files.pythonhosted.org/packages/04/fe/8c8ac01c7573e40699e84cf1f3ee19eb775fabe38044ef680d3122f9f0c7/venvy-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-03 17:08:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pranavkumaarofficial",
"github_project": "venvy#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "venvy"
}
JSON
