Getting started

anaconda-client is the command-line interface and client library for Anaconda.org. Use it to search for, upload, download, and manage packages, manage labels and collaborators, and configure authorization tokens—all from your terminal.

Most of these commands use the anaconda org command structure. Commands without the org prefix (for example, anaconda auth) are still supported.

Installation

To install anaconda-client, open Anaconda Prompt (Terminal on macOS/Linux) and run the following command:

conda install anaconda-client

If you installed Anaconda Distribution, anaconda-client should already be in your base environment. To check, run the following command:

conda list anaconda-client

Alternative installation methods

pip

pip install anaconda-client

pip install git+https://github.com/anaconda/anaconda-client

To verify your installation and view the installed version:

anaconda --version

Basic usage

Log in to Anaconda.org

To log in to your Anaconda.org account:

anaconda org login

Log in with your Anaconda credentials. Once authenticated, subsequent commands use your stored credentials automatically.

Check authentication status

To display information about the currently signed-in user:

anaconda org whoami

Search for a package

To search for a package on Anaconda.org:

anaconda org search <PACKAGE_NAME>

Upload a package

To upload a package to Anaconda.org:

anaconda org upload <FILE>

Log out

To remove stored credentials:

anaconda org logout

Configuration

anaconda-client reads configuration from a YAML file. Use the anaconda config command to view or modify settings.

View configuration

To display all configuration variables:

anaconda org config --show

To display config file locations:

anaconda org config --files

Set a configuration value

anaconda org config --set <NAME> <VALUE>

Configuration scopes

Common configuration options

For the full list of config options, see the config command reference.