Skip to main content
The Anaconda CLI (ana) lets you log in to Anaconda, manage tools, and configure package sources. You do not need Python or conda to install it. To create environments, use conda or pixi alongside ana.

Before you begin

  • Use macOS on Apple Silicon, Linux on x86_64 or aarch64, or Windows on x86_64.
  • On Windows, use PowerShell 5.1 or later.
  • Connect to the internet to download ana and its companion tools.
These instructions install the latest release. For release history, see Release notes.

Install

To install ana in %USERPROFILE%\.local\bin, run:
Open a new terminal after installation, then check that ana is ready to use:

Installation options

For a custom installation directory or automated setup, download the installer and pass the options you need: To inspect the shell installer’s full options without installing ana, run:
Keep download verification enabled. For login in automated workflows, see Authentication.

Authenticate

To connect ana to your Anaconda account, run:
Follow the browser prompts to sign in. Once complete, check your account:
For API key login, CI/CD configuration, and other authentication methods, see Authentication.

Set up companion tools

The installer attempts to set up companion tools automatically. If that step did not complete, or you skipped it, run the following after logging in:
Bootstrap installs the tools used by ana org and ana channel. Running it again leaves an existing installation unchanged. It does not install conda or add an anaconda command to your shell. For updates, see Update tools. MCP client setup is built into ana and does not require bootstrap. To learn more about the remote service and its capabilities, see Anaconda MCP. To see managed tools and available installer downloads, run:

Install an environment manager

If you already use conda or pixi, continue to configure package sources.
To download and verify the Miniconda installer for your platform, run:
Run the installation command printed by ana, or open the downloaded .exe on Windows. Ana downloads the installer but does not execute it. For the complete workflow, see Download and install Miniconda.

What’s next

Now that you’re set up, you can: