Anaconda Client command reference

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]

Option	Short	Description
`--verbose`	`-v`	Print debug information to the console
`--version`	`-V`	Show version and exit
`--help`	`-h`	Show command information and exit

Commands

`config`

Anaconda client configuration (alias for anaconda org config).

Usage: anaconda config [OPTIONS]

Options

General Options

Actions

Option	Description
`--set name value`	Sets a new variable: name value
`--get name`	Gets value: name
`--remove REMOVE`	Removes a variable
`--show`	Show all variables
`-f, --files`	Show the config file names
`--show-sources`	Display all identified config sources

Location Options

Option	Description
`-u, --user`	Set a variable for this user
`-s, --system, --site`	Set a variable for all users on this machine

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

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

Options

General Options

Copy Options

Option	Description
`--to-owner TO_OWNER`	User account to copy package to (default: your account)
`--from-label FROM_LABEL`	Label to copy packages from
`--to-label TO_LABEL`	Label to put all packages into
`--replace`	Overwrite destination package metadata
`--update`	Update missing data in destination package metadata

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

Argument	Description
`<HANDLE>`	`[CHANNEL_NAME/]<PACKAGE_NAME>`

Options

General Options

Download Options

Option	Description
`-f, --force`	Overwrite
`-o OUTPUT, --output OUTPUT`	Download as
`-t PACKAGE_TYPE, --package-type PACKAGE_TYPE`	Set the package type [`conda`, `env`, `file`, `ipynb`, `pypi`, `r`, `project`, `installer`]. Defaults to downloading all package types available

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

General Options

Actions

Option	Description
`--copy LABEL LABEL`	Copy label
`--list`	List all labels for a user
`--show LABEL`	Show all of the files in a label
`--lock LABEL`	Lock a label
`--unlock LABEL`	Unlock a label
`--remove LABEL`	Remove a label

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

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

Options

General Options

Move Options

Option	Description
`--from-label FROM_LABEL`	Label to move packages from
`--to-label TO_LABEL`	Label to move packages to

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

Argument	Description
`<USER/PACKAGE>`	Package to operate on

Options

General Options

Actions

Option	Description
`--add-collaborator USER`	Username of the collaborator you want to add
`--list-collaborators`	List all of the collaborators in a package
`--create`	Create a package

Metadata Arguments

Option	Description
`--summary SUMMARY`	Set the package short summary
`--license LICENSE`	Set the package license
`--license-url LICENSE_URL`	Set the package license url

Privacy

Option	Description
`--personal`	Set the package access to personal. This package will be available only on your personal registries
`--private`	Set the package access to private. This package will require authorized and authenticated access to install

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

Argument	Description
`<SPEC>`	Package written as `<user>[/<package>[/<version>[/<filename>]]]`

Options

General 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`

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

Usage: anaconda search [OPTIONS] <NAME>

For most use cases, conda search is the preferred way to search for a package. If you installed with Anaconda Distribution or Miniconda, conda searches for packages in Anaconda’s default channels unless configured otherwise. The anaconda search command searches all public channels on Anaconda.org and might return results that are not in the default channels. For more information on searching for packages with conda search, see Searching for conda packages.

Arguments

Argument	Description
`<NAME>`	Search string

Options

General Options

Search Filters

Option	Description
`-t PACKAGE_TYPE, --package-type PACKAGE_TYPE`	Only search for packages of this type: [`conda`, `env`, `file`, `ipynb`, `pypi`, `r`, `project`, `installer`]
`-p PLATFORM, --platform PLATFORM`	Only search for packages of the chosen platform: [`osx-32`, `osx-64`, `win-32`, `win-64`, `linux-32`, `linux-64`, `linux-aarch64`, `linux-armv6l`, `linux-armv7l`, `linux-ppc64le`, `linux-s390x`, `noarch`]

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

Argument	Description
`<SPEC>`	Package written as `user[/package[/version[/file]]]`

Options

General 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

Argument	Description
`<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

General Options

Update Release

Option	Description
`--release`	Use `source` file to update public attributes of the release specified in `spec`

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

Argument	Description
`<FILE>`	Distributions to upload

Options

General Options

Option	Description
`-h, --help`	Show help message and exit
`--no-progress`	Don’t show upload progress
`-u USER, --user USER`	User account or organization; defaults to the current user
`--keep-basename`	Do not normalize a basename when uploading a conda package. Note: this parameter only applies to conda, and not standard Python packages

Label Options

Option	Description
`-l LABELS, --label LABELS`	Add this file to a specific label. Warning: if the file labels do not include “main”, the file will not show up in your user labels

Upload Behavior

Option	Description
`--no-register`	Don’t create a new package namespace if it does not exist
`--register`	Create a new package namespace if it does not exist
`--build-id BUILD_ID`	Anaconda repository build ID (internal only)
`-i, --interactive`	Run an interactive prompt if any packages are missing
`-f, --fail`	Fail if a package or release does not exist (default)
`--force`	Force a package upload regardless of errors
`--skip-existing`	Skip errors on package batch upload if it already exists
`-m, --force-metadata-update`	Overwrite existing release metadata with the metadata from the package

Metadata Options

Option	Description
`-p PACKAGE, --package PACKAGE`	Defaults to the package name in the uploaded file
`-v VERSION, --version VERSION`	Defaults to the package version in the uploaded file
`-s SUMMARY, --summary SUMMARY`	Set the summary of the package
`-t PACKAGE_TYPE, --package-type PACKAGE_TYPE`	Set the package type. Defaults to autodetect
`-d DESCRIPTION, --description DESCRIPTION`	Description of the file(s)
`--thumbnail THUMBNAIL`	Notebook’s thumbnail image
`--private`	Create the package with private access

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

General Options

Option	Description
`--version, -V`	Show version
`--help`	Show help message and exit

Commands

Command	Description	Arguments
`api-key`	Display API key for signed-in user
`login`	Log in to Anaconda.com	`[--force \| --no-force] [--ssl-verify \| --no-ssl-verify]`
`logout`	Log out of Anaconda.com
`whoami`	Display 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

Command	Description
`auth`	Manage authorization tokens
`config`	Anaconda Client configuration
`copy`	Copy packages from one account to another
`download`	Download packages from your Anaconda repository
`groups`	Group management
`label`	Manage your Anaconda repository channels
`login`	Authenticate a user
`logout`	Log out from binstar
`move`	Move packages between labels
`package`	Anaconda repository package utilities
`remove`	Remove an object from your Anaconda repository
`search`	Search in your Anaconda repository
`show`	Show information about an object
`update`	Update public attributes of the package or the attributes of the package release
`upload`	Upload packages to your Anaconda repository
`whoami`	Print 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

General Options

Option	Description
`--help`	Show help message and exit

Commands

Command	Description	Arguments
`config`	Configure conda’s default channels to access Anaconda’s premium repository	`[TOKEN] [--force \| --no-force] [-o \| --org TEXT] [--set-default-channels \| --no-set-default-channels]`
`install`	Create and install a new repository token
`list`	List all installed repository tokens
`uninstall`	Uninstall 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

Sign into Anaconda services.

Usage: anaconda login [OPTIONS]

Options

General Options

Option	Description
`--at TEXT`	Choose from [`anaconda.com`, `anaconda.org`] [default: None]
`--help`	Show help message and exit

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

General Options

Option	Description
`--at TEXT`	Choose from [`anaconda.com`, `anaconda.org`] [default: None]
`--help`	Show help message and exit

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

General Options

Option	Description
`--at TEXT`	Choose from [`anaconda.com`, `anaconda.org`] [default: None]
`--help`	Show help message and exit

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

Option	Description
`-h, --help`	Show help message and exit
`--type TYPE`	The type of the values in the set commands

Option	Description
`-h, --help`	Show help message and exit
`-o ORGANIZATION, --organization ORGANIZATION`	Manage an organization’s labels

Tools

​Global options

​Commands

​config

​copy

​download

​label

​move

​package

​remove

​search

​show

​update

​upload

​Plugins

​auth

​org

​token

​Authentication

​login

​logout

​whoami

Global options

Commands

`config`

`copy`

`download`

`label`

`move`

`package`

`remove`

`search`

`show`

`update`

`upload`

Plugins

`auth`

`org`

`token`

Authentication

`login`

`logout`

`whoami`