Home

Awesome

Gator

The Mamba Navigator, a Web UI for managing conda environments

Binder Install with conda npm Github Actions Status Coverage Status Swagger Validator

Provides Conda/Mamba environment and package management as a standalone application or as extension for JupyterLab.

Install

Requirements

Starting from 3.4, this extension will use mamba instead of conda if it finds it.

To install in the classical notebook:

mamba install -c conda-forge mamba_gator

To install in the JupyterLab:

mamba install -c conda-forge jupyterlab mamba_gator

If you use JupyterLab 1.x or 2.x, you can install the extension with the following command:

jupyter labextension install @mamba-org/gator-lab

Optionally, you could install jupyterlab-tour to add a help tour for the conda packages manager.

JupyterLab

This extension adds a new entry Conda Packages Manager in the Settings menu.

The first time, it can take quite some time to build the available packages list. But once it is obtained, it will be cached and updated to the background to have a smoother user experience.

jupyterlab_conda_extension

Gator (Mamba navigator)

This project contains a standalone navigator application sharing much of the code of the JupyterLab extension.

Classical Jupyter Notebook

The classical Jupyter Notebook is supported only for version prior to 5. But you can directly manage the conda environments with the standalone navigator tool. For that you need to execute the following command in a terminal:

gator

Creating New Environments

There are three ways to create an environment:

Try it online

Open Gator (Mamba Navigator): Binder

Open JupyterLab: Binder

lab-launcher

Development

mamba create -c conda-forge -y -n gator python jupyterlab=3
mamba install -c conda-forge -y -n gator --file requirements_dev.txt
conda activate gator
pip install -e .
jupyter server extension enable mamba_gator --sys-prefix

yarn install
yarn run build:dev
jupyter labextension link packages/common/ packages/labextension/

Acknowledgements

This work started as a fork by @fcollonval of the Anaconda nb_conda package. The decision to fork it came due to apparently dead status of the previous package and a need to integrate it within JupyterLab.

Then with the mamba initiative pushed by QuantStack it made sense to move the project in the mamba-org organization.

Changelog

5.1.2

5.1.1

5.1.0

5.0.0

4.1.0

4.0.0

3.4.1

3.4.0

3.3.1

3.3.0

3.2.0

3.1.0

3.0.0

2.5.1

2.5.0

2.4.2

2.4.1

2.4.0

2.3.x

2.2.1

2.2.0

2.1.0

2.0.0

1.1.0

1.0.1

1.0.0