Need help with conda?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

4.3K Stars 1.1K Forks Other 15.8K Commits 2.1K Opened issues


OS-agnostic, system-level binary package manager and ecosystem

Services available


Need anything else?

Contributors list

.. NOTE: This file serves both as the README on GitHub and the index.html for If you update this file, be sure to cd to the web directory and run

make html; make live

.. image:: :alt: Conda Logo

.. image:: :target: :alt: CI Tests (GitHub Actions)

.. image:: :target: :alt: CI Images (GitHub Actions)

.. image:: :alt: Codecov Status :target:

.. image:: :alt: latest release version :target:

Conda is a cross-platform, language-agnostic binary package manager. It is the package manager used by

_ installations, but it may be used for other systems as well. Conda makes environments first-class citizens, making it easy to create independent environments even for C libraries. Conda is written entirely in Python, and is BSD licensed open source.

Conda is enhanced by organizations, tools, and repositories created and managed by the amazing members of the conda community. Some of them can be found



Conda is a part of the

Anaconda Distribution 
. Use
to bootstrap a minimal installation that only includes conda and its dependencies.

Getting Started

If you install Anaconda, you will already have hundreds of packages installed. You can see what packages are installed by running

.. code-block:: bash

$ conda list

to see all the packages that are available, use

.. code-block:: bash

$ conda search

and to install a package, use

.. code-block:: bash

$ conda install

The real power of conda comes from its ability to manage environments. In conda, an environment can be thought of as a completely separate installation. Conda installs packages into environments efficiently using

hard links
_ by default when it is possible, so environments are space efficient, and take seconds to create.

The default environment, which

itself is installed into is called
. To create another environment, use the
conda create
command. For instance, to create an environment with the IPython notebook and NumPy 1.6, which is older than the version that comes with Anaconda by default, you would run

.. code-block:: bash

$ conda create -n numpy16 ipython-notebook numpy=1.6

This creates an environment called

with the latest version of the IPython notebook, NumPy 1.6, and their dependencies.

We can now activate this environment, use

.. code-block:: bash

# On Linux and Mac OS X $ source activate numpy16

# On Windows

activate numpy16

This puts the bin directory of the

environment in the front of the
, and sets it as the default environment for all subsequent conda commands.

To go back to the base environment, use

.. code-block:: bash

# On Linux and Mac OS X $ source deactivate

# On Windows


Building Your Own Packages

You can easily build your own packages for conda, and upload them to 
, a free service for hosting packages for conda, as well as other package managers. To build a package, create a recipe. Package building documentation is available
. See for the recipes that make up the Anaconda Distribution and
_ and
_ are community-driven conda-based distributions.

To upload to, create an account. Then, install the anaconda-client and login

.. code-block:: bash

$ conda install anaconda-client $ anaconda login

Then, after you build your recipe

.. code-block:: bash

$ conda build

you will be prompted to upload to

To add your channel, or the channel of others to conda so that

conda install
will find and install their packages, run

.. code-block:: bash

$ conda config --add channels


with the user name of the person whose channel you want to add).

Getting Help

The documentation for conda is at You can subscribe to the

conda mailing list
. The source code and issue tracker for conda are on


Contributions to conda are welcome. See the

_ documentation for instructions on setting up a development environment.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.