Skip to content

Installing Neptune#


Software Version Website
Python 3.7+
pip or conda -


neptune 1.0 is released

We've released a major version of the Neptune client library. To see all the changes and detailed instructions, see the neptune 1.0 upgrade guide.

Upgrading with neptune-client already installed

Important: To smoothly upgrade to the 1.0 version of the Neptune client library, first uninstall the neptune-client library and then install neptune.

pip uninstall neptune-client
pip install neptune

To install the Neptune client library, open a terminal and enter the following command:

pip install neptune
conda install -c conda-forge neptune
Installing through Anaconda Navigator

To find neptune, you may need to update your channels and index.

  1. In the Navigator, select Environments.
  2. In the package view, click Channels.
  3. Click Add..., enter conda-forge, and click Update channels.
  4. In the package view, click Update index... and wait until the update is complete. This can take several minutes.
  5. You should now be able to search for neptune.

Note: The displayed version may be outdated. The latest version of the package will be installed.

Note: On Bioconda, there is a "neptune" package available which is not the client library. Make sure to specify the "conda-forge" channel when installing

Where to enter the command
  • Linux: Command line
  • macOS: Terminal app
  • Windows: PowerShell or Command Prompt
  • Jupyter Notebook: In a cell, prefixed with an exclamation mark: ! your-command-here

Additional setup#

Next steps#

Get started with using Neptune:

For a practical model-training and experiment-tracking example, see:

Looking to use Neptune together with another library or tool? For setup and examples, see:

Need more help with getting started?

The Neptune tutorial walks you through the complete setup process and all the Neptune essentials.