Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

pip/virtualenv shell script wrapper

Project Description


A utility wrapper for pip_ and virtualenv_.


A shell script facade for creating virtual python environments via virtualenv_
and installing packages within the environment via pip_.


virtualenv_ must be available, eg. in Ubuntu:

$ sudo apt-get install python-virtualenv

pip_ need not be available - it is installed every time to a new environment.

To install, use easy_install to install from

easy_install -Z orb

or simply copy the orb script from the source distribution, eg. ::

$ sudo cp orb /usr/local/bin


Create a virtualenv with the command

$ orb init myenv


$ orb init2 myenv

to use the latest Python2 as the executable, or

$ orb init3 myenv

to use the latest Python3 as the executable, or

$ orb init?.? myenv

(eg. orb init2.6 or orb init3.2) to specify a particular Python version as
the executable.

.. note::

the various python versions are assumed to be installed and on the user's

This creates a virtualenv called 'myenv' and creates an empty '.orb'
file within the virtualenv directory. Subsequent orb commands first search
for the '.orb' file and from this file's location the virtualenv's bin directory
is known.

To install packages to the env, run the 'orb install' command from within the
env directory::

cd myenv
orb install Pygments
orb install BeautifulSoup

which calls 'pip_' to do the actual downloading and installation.

If passed a python script, orb will call it using the virtualenv's python

eg. orb install

and if passed any command expression, orb will temporarily alter the
environment (ie. pip's `source activate` step) before eval-ing the command::

eg. (Django): orb startproject myproj
eg. (Python prompt): orb python
eg. (Sphinx quickstart): orb sphinx-quickstart
eg. (Sphinx build): orb make html
eg. (Arbitrary command) orb ./myshellscript

Other options:

orb ls - list contents of env's site-packages directory
orb link - symlink from the virtual env's site-packages to a system package
orb download PACKAGE [DEST]
- just download package, don't install

.. _virtualenv:
.. _pip:

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


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
(4.4 kB) Copy SHA256 Hash SHA256
Source None Apr 3, 2012

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers