# Install virtualenvwrapper with Homebrew, apt Python virtualenv extensions. Version 6.1.1 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:virtualenvwrapper ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install virtualenvwrapper ``` Evidence: local Homebrew formula metadata ### Linux - Debian apt (92%): ```sh sudo apt install python3-virtualenvwrapper ``` Evidence: Debian stable package indexes: python3-virtualenvwrapper from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz ## Package facts - **Package key:** brew:virtualenvwrapper - **Package manager:** Homebrew - **Package manager page:** - **Version:** 6.1.1 - **Source summary:** Python virtualenv extensions - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - virtualenvwrapper.sh (cli) - virtualenvwrapper_lazy.sh (cli) - virtualenvwrapper.sh (alias) - virtualenvwrapper_lazy.sh (alias) ## Dependencies - python@3.14 ## Install behavior - Post-install hook: not defined - Caveats: To activate virtualenvwrapper, add the following to your shell profile e.g. ~/.profile or ~/.zshrc source virtualenvwrapper.sh - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 6.1.1 - Local data: ok - Upstream repository: https://virtualenvwrapper.readthedocs.io/ - info: No package-manager update timestamp was available. - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage virtualenvwrapper is Doug Hellmann's shell layer around Ian Bicking's virtualenv. It collects virtual environments in one place and adds commands such as `mkvirtualenv`, `rmvirtualenv`, and `workon`, plus tab completion, hooks, and plugins for people who manage many Python projects from a Bourne-compatible shell. ### Project history Hellmann introduced the idea publicly in a May 2008 Python Magazine article, explaining that he had been using virtualenv for all projects but that keeping track of many environments had become messy. The solution was a set of bash functions that wrapped virtualenv and made switching, creating, and cleaning environments routine. The project documentation copyright and changelog history begin in the 2009 era, and the stable changelog records a 1.0 entry as the first copy and start of the new project. Over the 2.x through 4.x lines, virtualenvwrapper accumulated the conventions that made it recognizable: WORKON_HOME, project directories, pre/post activation hooks, and a plugin system. The 5.x and 6.x era reflects the long tail of Python packaging change. The current documentation warns that 5.x requires virtualenv 20+, while the 6.x releases moved the project forward with refreshed packaging while preserving the shell-first model. ### Adoption history virtualenvwrapper became a common recommendation for Python developers who lived in bash or zsh and worked on many projects at once. It did not replace virtualenv; it standardized the human workflow around virtualenv by making environment names, activation, deletion, and per-project hooks memorable. Its influence is visible in later tools and ports. virtualenvwrapper-win brought the idea to Windows batch scripts, while VirtualFish and other shell-specific managers borrowed the model for shells that did not use Bourne-compatible activation syntax. ### How it is used A typical setup defines WORKON_HOME, sources `virtualenvwrapper.sh` from a shell startup file, then uses `mkvirtualenv NAME` to create an environment and `workon NAME` to switch back to it. Hooks such as preactivate, postactivate, predeactivate, and postdeactivate let users automate per-environment shell state. The package is mostly a workflow tool rather than a runtime dependency. It matters on developer machines, CI bootstrap scripts, and old-but-still-working Python development setups where quick environment switching is more valuable than a project-level lockfile system. ### Why package nerds care virtualenvwrapper is historically important because it turned virtualenv from a command you remembered into a workspace model. For package people, `workon` and WORKON_HOME became shorthand for the pre-Poetry, pre-uv period of Python environment management: practical shell glue that solved the daily mess. ### Timeline - 2008-05: Doug Hellmann published an article describing wrappers around virtualenv. - 2009: virtualenvwrapper documentation and changelog history begin around the early project era. - 2010: PyPI release history visible today includes 2.5.3 uploads. - 2023: virtualenvwrapper 6.0.0 refreshed the project for modern packaging. - 2024: virtualenvwrapper 6.1.1 was released. ### Related projects - virtualenv is the underlying environment creator. virtualenvwrapper-win is a Windows port of the same idea. VirtualFish adapts similar virtualenv-management ergonomics to the fish shell. ### Sources - Doug Hellmann's original virtualenvwrapper article: https://doughellmann.com/posts/virtualenvwrapper/ - virtualenvwrapper 6.0.0 release note: https://doughellmann.com/releases/virtualenvwrapper-6-0-0/ - virtualenvwrapper GitHub README: https://github.com/python-virtualenvwrapper/virtualenvwrapper - virtualenvwrapper PyPI project: https://pypi.org/project/virtualenvwrapper/ - virtualenvwrapper documentation: https://virtualenvwrapper.readthedocs.io/ - virtualenvwrapper stable changelog: https://virtualenvwrapper.readthedocs.io/en/stable/history.html ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: shell startup file that sources virtualenvwrapper.sh, for example ~/.bashrc, ~/.profile ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** virtualenvwrapper - **Version Scheme:** 0 - **Revision:** 2 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Debian apt - python3-virtualenvwrapper - 4.8.4-4: normalized package name match | Debian stable package indexes: python3-virtualenvwrapper from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | extension to virtualenv for managing multiple environments (Py3) | https://virtualenvwrapper.readthedocs.io/en/latest/ - Debian apt - virtualenvwrapper - 4.8.4-4: normalized package name match | Debian stable package indexes: virtualenvwrapper from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | extension to virtualenv for managing multiple environments | https://virtualenvwrapper.readthedocs.io/en/latest/ - Debian apt - virtualenvwrapper-doc - 4.8.4-4: normalized package name match | Debian stable package indexes: virtualenvwrapper-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | extension to virtualenv for managing multiple environments (docs) | https://virtualenvwrapper.readthedocs.io/en/latest/ - Ubuntu apt - python3-virtualenvwrapper - 4.8.4-4ubuntu1: normalized package name match | Ubuntu 24.04 LTS package indexes: python3-virtualenvwrapper from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | extension to virtualenv for managing multiple environments (Py3) | https://virtualenvwrapper.readthedocs.io/en/latest/ - Ubuntu apt - virtualenvwrapper - 4.8.4-4ubuntu1: normalized package name match | Ubuntu 24.04 LTS package indexes: virtualenvwrapper from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | extension to virtualenv for managing multiple environments | https://virtualenvwrapper.readthedocs.io/en/latest/ - Ubuntu apt - virtualenvwrapper-doc - 4.8.4-4ubuntu1: normalized package name match | Ubuntu 24.04 LTS package indexes: virtualenvwrapper-doc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | extension to virtualenv for managing multiple environments (docs) | https://virtualenvwrapper.readthedocs.io/en/latest/ ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [pyenv-virtualenv](https://www.automicvault.com/pkg/brew/pyenv-virtualenv/) - Shares av.db curated category or tags: cli, developer-tools, environment-management, python, virtualenv. - [virtualfish](https://www.automicvault.com/pkg/brew/virtualfish/) - Shares av.db curated category or tags: cli, developer-tools, environment-management, python, virtualenv. - [fades](https://www.automicvault.com/pkg/brew/fades/) - Shares av.db curated category or tags: cli, developer-tools, environment-management, python, virtualenv. - [pyenv-virtualenvwrapper](https://www.automicvault.com/pkg/brew/pyenv-virtualenvwrapper/) - Shares av.db curated category or tags: cli, developer-tools, environment-management, python, virtualenv. - [pyenv-pip-migrate](https://www.automicvault.com/pkg/brew/pyenv-pip-migrate/) - Shares av.db curated category or tags: cli, developer-tools, environment-management, python. - [rye](https://www.automicvault.com/pkg/brew/rye/) - Shares av.db curated category or tags: cli, developer-tools, python, virtualenv. - [abi3audit](https://www.automicvault.com/pkg/brew/abi3audit/) - Shares av.db curated category or tags: cli, developer-tools, python. - [chardet](https://www.automicvault.com/pkg/brew/chardet/) - Shares av.db curated category or tags: cli, developer-tools, python. ## Combined YAML source View the package source record on GitHub. [combined/virtualenvwrapper.yml](https://github.com/automic-vault/db/blob/main/combined/virtualenvwrapper.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph