> ## Documentation Index
> Fetch the complete documentation index at: https://anaconda.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

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

> [!NOTE]
>
> 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 (A command-line application included with Windows installations of Anaconda Distribution and Miniconda. Find it by searching 'Anaconda Prompt' in the Windows Start menu.) (Terminal on macOS/Linux) and run the following command:

```sh theme={null}
conda install anaconda-client
```

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

```sh theme={null}
conda list anaconda-client
```

> [accordion] Alternative installation methods
>
> ```sh pip theme={null}
> pip install anaconda-client
> ```
>
> ```sh pip from source theme={null}
> pip install git+https://github.com/anaconda/anaconda-client
> ```

To verify your installation and view the installed version:

```sh theme={null}
anaconda --version
```

## Basic usage

### Log in to Anaconda.org

To log in to your Anaconda.org account:

```sh theme={null}
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:

```sh theme={null}
anaconda org whoami
```

### Search for a package

To search for a package on Anaconda.org:

```sh theme={null}
anaconda org search <PACKAGE_NAME>
```

Comments

Replace \<PACKAGE\_NAME> with the name of the package to search for.

### Upload a package

To upload a package to Anaconda.org:

```sh theme={null}
anaconda org upload <FILE>
```

Comments

Replace \<FILE> with the path to the distribution file to upload (for example, a `.conda` or `.tar.bz2` file).

### Log out

To remove stored credentials:

```sh theme={null}
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:

```sh theme={null}
anaconda org config --show
```

To display config file locations:

```sh theme={null}
anaconda org config --files
```

### Set a configuration value

```sh theme={null}
anaconda org config --set <NAME> <VALUE>
```

Comments

Replace \<NAME> with the configuration variable name.\\

Replace \<VALUE> with the preferred value.

### Configuration scopes

Scope

Flag

Description

User

`-u, --user`

Set a variable for the current user (default)

System

`-s, --system`

Set a variable for all users on this machine

### Common configuration options

Parameter

Default

Description

`url`

`https://api.anaconda.org`

Anaconda.org API URL

`ssl_verify`

`True`

Enable SSL verification for API requests

`auto_register`

`True`

Automatically create a package namespace when uploading if it does not exist

For the full list of `config` options, see the [config command reference](https://anaconda.com/docs/cli-reference/anaconda-client/commands/config.md).