Skip to main content

Cross-platform Python environment management.

Project description


Cross-platform Python environment management.


pip install cpenv

Environment Variables

  • $CPENV_HOME - Path where environments will be created (default: ~/.cpenv)
  • $CPENV_ACTIVE - Path to active environment
  • $CPENV_APP - Path to active app module


cpenv create test

Create an environment named test.


cpenv activate test

All activated environments are stored in a cache in ~/.cpenv/envcache.yml. First environments are looked up by name in CPENV_HOME path, then looked up in envcache.yml. This means you can store and activate environments by name regardless of where they are stored on the file system, so long as you activate them once by full path. The paths stored in the cache are validated each time you run cpenv.


Each environment runs in a subshell so deactivation is handled through the shell command exit.


Modules are sub environments used to configure DCC applications like Autodesk Maya and The Foundry’s Nuke. You can find two examples of Modules at and Each Module includes a module.yml file with a command to launch the application, environment variables, and any python dependencies the Module requires.

Create a Module

cpenv create --module maya2016

Adds the default maya Module to the active environment test. All Modules are installed to $CPENV_ACTIVE/modules.

Launch a Module

cpenv launch maya2016

Launches maya2016 Module using the command and arguments provided in the module.yml file. You can also pass additional args here:

cpenv launch maya2016 “/path/to/maya_file.mb”

Remove a Module

cpenv remove --module maya2016

Removing Virtual Environments

cpenv remove test

Project details

Download files

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

Files for cpenv, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size cpenv-0.2.0-py2.py3-none-any.whl (120.5 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size cpenv-0.2.0.tar.gz (100.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page