Managing packages#

On the Environments page, the packages table in the right column lists the packages included in the environment selected in the left column.

Note

Packages are managed separately for each environment. Changes you make to packages only apply to the active environment.

Tip

The Update Index button refreshes the packages table with all packages that are available in any of the enabled channels.

Filtering the packages table#

By default, only installed packages are shown in the packages table. To filter the table to show different packages:

  1. Click the dropdown next to Channels.

  2. Select which types of packages to display.

Note

Selecting the Updatable filter option lists packages that are installed and have updates available.

Searching for packages#

To search for a specific package, type all or part of the package’s name into the Search Packages box.

The results of the search depend on:

  • the channels added to Navigator,

  • the selected package list filter option, and

  • the environment selected, if searching for already-installed packages

If a package you are expecting doesn’t appear in the search, make sure you have the correct filter option and environment selected. If the package is not available in the default channels, make sure the correct channels are added to your Channels list.

Installing a package#

  1. Select the environment where you want to install the package.

    Note

    Anaconda does not recommend installing packages in your base environment.

  2. Select the Not Installed filter option to list all packages that are available in the environment’s channels, but not installed.

    Note

    Only packages that are compatible with your current environment are listed.

  3. Use the Search Packages box to narrow the package options, if necessary.

  4. Select the package you want to install.

  5. Click Apply.

  6. Review the Install Packages information. This dialog lists the packages chosen for installation and all dependencies of those packages that also need to be installed.

    You can sort the list of packages to be installed by the following information:

    Name

    The name of the package.

    Unlink

    The package version being uninstalled.

    Link

    The package version being installed.

    Channel

    The channel from which the package is being installed.

    Action

    The action being taken. In this case, “Install”.

  7. Click Apply.

    Tip

    If a new package doesn’t appear in the packages table after you install it, select the Home page, then click Refresh to reload the packages table.

Confirming a package is installed correctly#

Once a package is installed, it appears in the Installed package list for the given environment, but another way to confirm that a package is installed correctly is by opening a Jupyter Notebook in that environment, importing the package, and displaying its help text. These instructions assume you created an environment named biopython and installed the BioPython package into it.

  1. On the Home page, select the biopython environment from the environment dropdown.

  2. Click Install on the Jupyter Notebook application tile to install it into the biopython environment.

  3. Launch Jupyter Notebook from its application tile.

  4. In the Jupyter Notebook, click New and select the Python 3 kernel.

  5. Copy and paste the following code into the first cell:

    import Bio
    help(Bio)
    
  6. To run the code, click Run or use the keyboard shortcut Ctrl + Enter (or Ctrl + Return in macOS).

  7. The BioPython help text is displayed.

    Note

    To determine the import name of a package (such as Bio for BioPython), search the package’s documentation.

Updating a package#

To mark packages for updating:

  1. Select the Updatable filter option to list all installed packages that have updates available.

  2. Select the blue arrow on the line(s) of the package(s) you want to update.

  3. Click Apply.

Installing a different package version#

  1. Select the checkbox next to the package whose version you want to change.

  2. Select Mark for specific version installation. If other versions are available for this package, they are displayed in a list.

  3. Select the package version you want to install.

  4. Click Apply.

Removing a package#

  1. Select the checkbox next to the package you want to remove.

  2. Select Mark for removal.

  3. Click Apply.

Advanced package management#

Navigator provides a convenient graphical interface for managing conda environments, channels, and packages. But if you’re comfortable working with Anaconda Prompt (terminal on Linux or macOS), you can access additional, advanced management features. To learn more, see Managing packages in the conda documentation.