Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Store conda environment package list inside Notebook documents

Project description

Store conda environment package list inside Notebook documents

This package provides a hook for the Jupyter Notebook that saves metadata about the conda environment (equivalent of conda env export) inside the Notebook .ipynb file everytime that the Notebook is saved. It also supports packages installed inside the conda environment with pip.

Once such Jupyter Notebook is shared, another user can inspect the environment where it ran:

$ nbenv --extract my_notebook.ipynb

name: test_input_env
- defaults
- conda-forge
- ca-certificates=2017.08.26=h1d4fec5_0
- certifi=2017.7.27.1=py35h19f42a1_0
- decorator=4.1.2=py35h3a268aa_0
- ipykernel=4.6.1=py35h29d130c_0
- ipython=6.1.0=py35h1b71439_1
- ipython_genutils=0.2.0=py35hc9e07d0_0
- jupyter_client=5.1.0=py35h2bff583_0
- pip:
  - ipython-genutils==0.2.0
  - jupyter-client==5.1.0

And re-create the same environment (includes install of IPython Kernel):

$ nbenv my_notebook.ipynb --name reconstructed_env
$ source activate reconstructed_env
$ jupyter notebook

The environment metadata will be preserved if the Notebook file is modified by a Jupyter Notebook session with no nbenv installed.


Install the package with pip install nbenv

Install the Jupyter Notebook hook in your .jupyter/

    from nbenv import save_conda_environment
    c.FileContentsManager.pre_save_hook = save_conda_environment
except ImportError:
    print("nbenv package not found: automatic saving of conda environment disabled")

Implementation details

The pre_save_hook is automatically triggered by the Jupyter Notebook before saving the Notebook to disk. It identifies the conda environment being run checking the KernelSpec and then calls conda env export and saves the output in ["content"]["metadata"]["conda_environment"] in the .ipynb JSON.

The nbenv command line tool can then extract that and use conda create to a new environment.


Design of this package was conceived during discussion at the Container Analysis Environments Workshop held at NCSA in August 2017.

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

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 nbenv, version 0.1.4
Filename, size File type Python version Upload date Hashes
Filename, size nbenv-0.1.4-py2.py3-none-any.whl (7.9 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size nbenv-0.1.4.tar.gz (14.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page