Getting started with Navigator¶

Anaconda Navigator is a graphical user interface to the conda package and environment manager.

This 10-minute guide to Navigator will have you navigating the powerful conda program in a web-like interface without having to learn command line commands.

SEE ALSO: Getting started with conda to learn how to use conda. Compare the Getting started guides for each to see which program you prefer.

Before you start¶

You should have already installed Anaconda .

Contents¶

Starting Navigator on Windows, macOS or Linux. 1 MINUTE

Managing Navigator. Verify that Anaconda is installed and check that Navigator is updated to the current version. 1 MINUTE

Managing environments. Create environments and move easily between them. 3 MINUTES

Managing Python. Create an environment that has a different version of Python. 2 MINUTES

Managing packages. Find packages available for you to install. Install packages. 3 MINUTES

TOTAL TIME: 10 MINUTES

Starting Navigator¶

Windows

From the Start menu, click the Anaconda Navigator desktop app.
Or from the Start menu, search for and open “Anaconda Prompt” and type the command anaconda-navigator.

../../../_images/navigator-anaconda-prompt1.png

MacOS

Open Launchpad, then click the Anaconda-Navigator icon.
Or open Launchpad and click the Terminal icon. Then in Terminal, type anaconda-navigator.

Linux

Open a Terminal window and type anaconda-navigator.

Managing Navigator¶

Verify that Anaconda is installed and running on your system.

When Navigator starts up, it verifies that Anaconda is installed.

If Navigator does not start up, go back to Anaconda installation and make sure you followed all the steps.

Check that Navigator is updated to the current version.

When you start Navigator, it automatically checks for a new version. If Navigator finds a new version, you will see a dialog box like this:

Click the “Yes” button to update Navigator to the current version.

TIP: We recommend that you always keep Navigator updated to the latest version.

Managing Environments¶

Navigator uses conda to create separate environments containing files, packages and their dependencies that will not interact with other environments.

Create a new environment named snowflakes and install a package in it:

In Navigator, click the Environments tab, then click the Create button.

The Create new environment dialog box appears.

In the Environment name field, type a descriptive name for your environment:

Click Create. Navigator creates the new environment and activates it:

Now you have two environments, the default environment base (root), and snowflakes.

Switch between them (activate and deactivate environments) by clicking the name of the environment you want to use.

TIP: The active environment is the one with the arrow next to its name.

Return to the other environment by clicking its name.

Managing Python¶

When you create a new environment, Navigator installs the same Python version you used when you downloaded and installed Anaconda. If you want to use a different version of Python, for example Python 3.5, simply create a new environment and specify the version of Python that you want in that environment.

Create a new environment named “snakes” that contains Python 3.5:

In Navigator, click the Environments tab, then click the Create button.

The Create new environment dialog box appears.
In the Environment name field, type the descriptive name “snakes” and select the version of Python you want to use from the Python Packages box (3.6, 3.5 or 2.7). Select a different version of Python than is in your other environments, base or snowflakes.
Click the Create button.
Activate the version of Python you want to use by clicking the name of that environment.

Managing packages¶

In this section, you check which packages you have installed, check which are available and look for a specific package and install it.

To find a package you have already installed, click the name of the environment you want to search. The installed packages are displayed in the right pane.

You can change the selection of packages displayed in the right pane at any time by clicking the drop-down box above it and selecting Installed, Not Installed, Updateable, Selected, or All.

Check to see if a package you have not installed named “beautifulsoup4” is available from the Anaconda repository (must be connected to the Internet):

On the Environments tab, in the Search Packages box, type beautifulsoup4, and from the Search Subset box select All or Not Installed.

To install the package into the current environment:

Check the checkbox next to the package name, then click the bottom Apply button.

The newly installed program is displayed in your list of installed programs.

More information¶

Full documentation—https://docs.anaconda.com/anaconda/navigator/

Free community support—https://groups.google.com/a/anaconda.com/forum/#!forum/anaconda

Paid support options—https://www.anaconda.com/support/

Training—https://www.anaconda.com/training/