Anaconda Client is the command line interface (CLI) for Anaconda.org, and can be used for logging in, logging out, managing your account, uploading files, generating access tokens, viewing tokens, and more! Visit the Getting started with Anaconda Client page for installation instructions for the anaconda-client package.

This page includes all Anaconda Client commands, their arguments, and their options.

Run anaconda --help or anaconda <COMMAND> -h in Anaconda Prompt (Terminal on macOS/Linux) to see this help text in your terminal.

Run the following commands in Anaconda Prompt (Terminal on macOS/Linux).

Looking for conda commands? See the official conda documentation for a full guide to conda commands.

In the command syntax, square brackets ([ ]) mean a parameter is optional and angle brackets (< >) mean it’s required. In the examples, angle brackets (< >) indicate values you should replace with your own.

Global options

Show help message, version, or enable verbose output.

Usage*: anaconda [GLOBAL OPTION]

OptionShortDescription
--verbose-vPrint debug information to the console
--version-VShow version and exit
--help-hShow command information and exit

Commands

config

Anaconda client configuration (alias for anaconda org config).

Usage: anaconda config [OPTIONS]

Options

Examples

# Show all config variables
anaconda config --show

# Show configuration file locations
anaconda config --files

copy

Copy packages from one account to another (alias for anaconda org copy, defaults to copying to your account).

Usage: anaconda copy [OPTIONS] <SPEC>

Arguments

ArgumentDescription
<SPEC>Package - written as user/package/version[/filename]. If filename is not given, copy all files in the version

Options

Examples

# Copy entire package version
anaconda copy <USER>/<PACKAGE>/<VERSION>
anaconda copy myusername/numpy/1.21.0

# Copy specific file from package from another user to your account
anaconda copy <USER>/<PACKAGE>/<VERSION>/<FILENAME>
anaconda copy otherusername/numpy/1.21.0/numpy-1.21.0-py39_0.conda

# Copy package to different owner
anaconda copy <USER>/<PACKAGE>/<VERSION> --to-owner <TO_OWNER>
anaconda copy myusername/numpy/1.21.0 --to-owner otherusername

download

Download packages from your Anaconda repository (alias for anaconda org download).

Usage: anaconda download [OPTIONS] <HANDLE>

Arguments

ArgumentDescription
<HANDLE>[CHANNEL_NAME/]<PACKAGE_NAME>

Options

Examples

# Download package from default channel
anaconda download <PACKAGE_NAME>
anaconda download numpy

# Download package from specific channel
anaconda download <CHANNEL_NAME>/<PACKAGE_NAME>
anaconda download myusername/numpy

# Download with custom output name
anaconda download <CHANNEL_NAME>/<PACKAGE_NAME> -o <OUTPUT_FILE>.conda
anaconda download myusername/numpy -o my-numpy-package.conda

label

Manage your Anaconda repository channels (alias for anaconda org label).

Usage: anaconda label [OPTIONS] <ACTION>

Options

Examples

# List all labels
anaconda label --list

# Show files in a specific label
anaconda label --show <LABEL_NAME>
anaconda label --show main

# Copy a label
anaconda label --copy <SOURCE_LABEL> <DEST_LABEL>
anaconda label --copy main dev

move

Move packages between labels (alias for anaconda org move).

Usage: anaconda move [OPTIONS] <SPEC>

Arguments

ArgumentDescription
<SPEC>Package - written as user/package/version[/filename]. If filename is not given, move all files in the version

Options

Examples

# Move entire package version between labels
anaconda move <USER>/<PACKAGE>/<VERSION> --from-label <SOURCE_LABEL> --to-label <DEST_LABEL>
anaconda move myusername/numpy/1.21.0 --from-label main --to-label dev

# Move specific file between labels
anaconda move <USER>/<PACKAGE>/<VERSION>/<FILENAME> --from-label <SOURCE_LABEL> --to-label <DEST_LABEL>
anaconda move myusername/numpy/1.21.0/numpy-1.21.0-py39_0.conda --from-label main --to-label dev

# Move from main label to specific label
anaconda move <USER>/<PACKAGE>/<VERSION> --to-label <DEST_LABEL>
anaconda move myusername/numpy/1.21.0 --to-label dev

package

Anaconda repository package utilities (alias for anaconda org package).

Usage: anaconda package [OPTIONS] <USER/PACKAGE> <ACTION>

Arguments

ArgumentDescription
<USER/PACKAGE>Package to operate on

Options

Examples

# Create a new package
anaconda package <USER>/<PACKAGE> --create --summary "<PACKAGE_DESCRIPTION>"
anaconda package myusername/numpy --create --summary "Numerical computing library"

# Add a collaborator to a package
anaconda package <USER>/<PACKAGE> --add-collaborator <COLLABORATOR_USERNAME>
anaconda package myusername/numpy --add-collaborator teammateusername

# List all collaborators
anaconda package <USER>/<PACKAGE> --list-collaborators
anaconda package myusername/numpy --list-collaborators

remove

Remove an object from your Anaconda repository.

Usage: anaconda remove [OPTIONS] <SPEC> [ADDITIONAL_SPECS ...]

Arguments

ArgumentDescription
<SPEC>Package written as <user>[/<package>[/<version>[/<filename>]]]

Options

Examples

# Remove specific file from package
anaconda remove <USER>/<PACKAGE>/<VERSION>/<FILENAME>
anaconda remove myusername/numpy/1.21.0/numpy-1.21.0-py39_0.conda

# Remove two entire package versions 
anaconda remove <USER>/<PACKAGE>/<VERSION> <USER>/<PACKAGE>/<VERSION>
anaconda remove myusername/numpy/1.21.0 myusername/scipy/1.7.0

# Force remove without confirmation
anaconda remove <USER>/<PACKAGE>/<VERSION> --force
anaconda remove myusername/numpy/1.21.0 --force

Search in your Anaconda repository (alias for anaconda org search).

Usage: anaconda search [OPTIONS] <NAME>

Arguments

ArgumentDescription
<NAME>Search string

Options

Examples

# Search for packages by name
anaconda search <PACKAGE_NAME>
anaconda search numpy

# Search for specific package type
anaconda search <PACKAGE_NAME> --package-type <PACKAGE_TYPE>
anaconda search pandas --package-type conda

# Search for packages on specific platform
anaconda search <PACKAGE_NAME> --platform <PLATFORM>
anaconda search matplotlib --platform linux-64

show

Show information about an object (alias for anaconda org show).

Usage: anaconda show [OPTIONS] <SPEC>

Arguments

ArgumentDescription
<SPEC>Package written as user[/package[/version[/file]]]

Options

Examples

# Show user information
anaconda show <USER>
anaconda show myusername

# Show package information
anaconda show <USER>/<PACKAGE>
anaconda show myusername/numpy

# Show specific version information
anaconda show <USER>/<PACKAGE>/<VERSION>
anaconda show myusername/numpy/1.21.0

update

Update public attributes of the package or the attributes of the package release (alias for anaconda org update).

Usage: anaconda update [OPTIONS] <SPEC> <SOURCE>

Arguments

ArgumentDescription
<SPEC>Package name written as user/package[/version]
<SOURCE>Path to the file that consists of metadata that will be updated in the destination package. It may be a valid package file or .json file with described attributes to update

Options

Examples

# Update package with conda package file
anaconda update <USER>/<PACKAGE>/<VERSION> <PACKAGE_FILE>.conda
anaconda update myusername/numpy/1.21.0 numpy-1.21.0-py39_0.conda

# Update package with metadata JSON file
anaconda update <USER>/<PACKAGE>/<VERSION> <METADATA_FILE>.json
anaconda update myusername/numpy/1.21.0 metadata.json

# Update release attributes
anaconda update <USER>/<PACKAGE>/<VERSION> <PACKAGE_FILE>.conda --release
anaconda update myusername/numpy/1.21.0 numpy-1.21.0-py39_0.conda --release

upload

Upload packages to your Anaconda repository (alias for anaconda org upload).

Usage: anaconda upload [OPTIONS] <FILE> [FILES ...]

Arguments

ArgumentDescription
<FILE>Distributions to upload

Options

Examples

# Upload a conda package
anaconda upload <PACKAGE_FILE>.conda
anaconda upload numpy-1.21.0-py39_0.conda

# Upload with custom metadata
anaconda upload <PACKAGE_FILE>.conda --summary "<PACKAGE_DESCRIPTION>" --private
anaconda upload numpy-1.21.0-py39_0.conda --summary "Numerical computing library" --private

# Upload to specific label
anaconda upload <PACKAGE_FILE>.conda --label <LABEL_NAME>
anaconda upload numpy-1.21.0-py39_0.conda --label dev

See Also

Plugins

auth

Anaconda.com authentication commands.

Usage: anaconda auth [OPTIONS] <COMMAND> [ARGS]...

Options

Commands

CommandDescriptionArguments
api-keyDisplay API key for signed-in user
loginLog in to Anaconda.com[--force | --no-force] [--ssl-verify | --no-ssl-verify]
logoutLog out of Anaconda.com
whoamiDisplay information about the current signed-in user

Examples

# Log in to anaconda.com
anaconda auth login

# Display current user information
anaconda auth whoami

# Show API key for current user
anaconda auth api-key

org

Interact with Anaconda.org.

Most anaconda org commands have convenient aliases available at the top level (for example, anaconda upload instead of anaconda org upload). See Commands for detailed documentation.

Usage: anaconda org [OPTIONS] COMMAND [ARGS]...

Commands

CommandDescription
authManage authorization tokens
configAnaconda Client configuration
copyCopy packages from one account to another
downloadDownload packages from your Anaconda repository
groupsGroup management
labelManage your Anaconda repository channels
loginAuthenticate a user
logoutLog out from binstar
moveMove packages between labels
packageAnaconda repository package utilities
removeRemove an object from your Anaconda repository
searchSearch in your Anaconda repository
showShow information about an object
updateUpdate public attributes of the package or the attributes of the package release
uploadUpload packages to your Anaconda repository
whoamiPrint the information of the current user

Examples

# Use top-level alias (recommended)
anaconda upload <PACKAGE_FILE>
anaconda upload numpy-1.21.0-py39_0.conda

# Or use full org command
anaconda org upload <PACKAGE_FILE>
anaconda org upload numpy-1.21.0-py39_0.conda

# Access org-specific auth commands
anaconda org auth --help

token

Manage your Anaconda repo tokens.

Usage: anaconda token [OPTIONS] <COMMAND> [ARGS]...

Options

Commands

CommandDescriptionArguments
configConfigure conda’s default channels to access Anaconda’s premium repository[TOKEN] [--force | --no-force] [-o | --org TEXT] [--set-default-channels | --no-set-default-channels]
installCreate and install a new repository token
listList all installed repository tokens
uninstallUninstall a repository token for a specific organization[-o | --org TEXT]

Examples

# List all installed tokens
anaconda token list

# Install a new repository token
anaconda token install

# Configure conda channels for premium repository with organization
anaconda token config --org <ORGANIZATION_NAME>
anaconda token config --org myorganization

Authentication

login

Sign into Anaconda services.

Usage: anaconda login [OPTIONS]

Options

Examples

# Login to default service
anaconda login

# Login to anaconda.com
anaconda login --at anaconda.com

# Login to anaconda.org
anaconda login --at anaconda.org

logout

Sign out from Anaconda services.

Usage: anaconda logout [OPTIONS]

Options

Examples

# Logout from default service
anaconda logout

# Logout from anaconda.com
anaconda logout --at anaconda.com

# Logout from anaconda.org
anaconda logout --at anaconda.org

whoami

Display account information.

Usage: anaconda whoami [OPTIONS]

Options

Examples

# Show current user information
anaconda whoami

# Show user info for anaconda.com
anaconda whoami --at anaconda.com

# Show user info for anaconda.org
anaconda whoami --at anaconda.org