Package for managing conda environment-based kernels inside of Jupyter
Python JavaScript
Latest commit fe86172 Jan 25, 2017 @damianavila damianavila committed on GitHub Merge pull request #59 from hadim/patch-1
Add a note in the README about installing kernel for each environment.


Manage your conda environment-based kernels inside the Jupyter Notebook.

This package defines a custom KernelSpecManager that automatically creates KernelSpecs for each conda environment. When you create a new notebook, you can choose a kernel corresponding to the environment you wish to run within. This will allow you to have different versions of python, libraries, etc. for different notebooks.

Important Note : To use a conda environment as a kernel, don't forget to install ipykernel in this environment or it won't show up in the kernel list.


conda install -c conda-forge nb_conda_kernels

Getting Started

You'll need conda installed, either from Anaconda or miniconda.

conda create -n nb_conda_kernels python=YOUR_FAVORITE_PYTHON
conda install -n nb_conda_kernels --file requirements.txt -c r
source activate nb_conda_kernels
python develop
python -m nb_conda_kernels.install --enable --prefix="${CONDA_PREFIX}"
# or on windows
python -m nb_conda_kernels.install --enable --prefix="%CONDA_PREFIX"

We still use npm for testing things, so then run:

npm install

Finally, you are ready to run the tests!

npm run test



  • change kernel naming scheme to leave default kernels in place


  • ignore build cleanup on windows due to poorly-behaved PhantomJS processes



  • minor build changes


  • update to notebook 4.2