Skip to main content

A virtual environment shell

Project description

A virtual environment shell


I was inspired by vex and pew to create a shell environment; I think that was the correct approach, but I wanted to extend the tool without any bureaucracy or red tape. Some of these choices could alienate the general community, so this is its own project.

  • Python 3.6+
  • Even more streamlined command-line interface
  • Production installation setting compatible with something like Ansible
  • Even better control on environment:
    • executes scripts (bash, python, other) upon startup and teardown
    • change environment variables


To install vsh, simply:

$ pip install vsh



Enter or Create and enter a new virtual environment:

$ vsh VenvName
(VenvName) $

Remove a previously created virtual environment:

$ vsh -r VenvName

Create an ephemeral virtual environment:

$ vsh -e VenvName

More Commands

See Command Reference

Environment Variables

Name Default Description
WORKON_HOME $HOME/.virtualenvs default, single path for venvs


To quickly startup in development mode, clone the source code from Github:

$ git clone vsh

Create and activate a virtual environment:

$ python3 -m venv $WORKON_HOME/vsh
$ $WORKON_HOME/vsh/bin/activate

Install vsh in development mode:

(vsh) $ cd vsh && pip install -e .[all]

Run the tests to verify that the setup is complete (and the tests pass):

(vsh) $ pytest --cache-clear

Please feel free to submit pull requests and file bugs using the issue tracker.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
vsh-0.6.1.tar.gz (77.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page