skip to navigation
skip to content

Not Logged In

conda 3.0.6

package management tool


Conda is a cross-platform, Python-agnostic binary package manager. It is the
package manager used by `Anaconda
<>`_ 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


Conda is a part of the `Anaconda distribution <>`_.  You can also download a
minimal installation that only includes conda and its dependencies, called
`Miniconda <>`_.

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 <package-name>

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 ``conda`` itself is installed into is called
``root``.  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 ``numpy16`` with the latest version of
the IPython notebook, NumPy 1.6, and their dependencies.

We can now activate this environment. On Linux and Mac OS X, use

.. code-block:: bash

   $ source activate numpy16

This puts the bin directory of the ``numpy16`` environment in the front of the
``PATH``, and sets it as the default environment for all subsequent conda commands.

To go back to the root environment, use

.. code-block:: bash

   $ source deactivate

Building Your Own Packages

You can easily build your own packages for conda, and upload them to `Binstar
<>`_, a free service for hosting packages for conda, as
well as other package managers.  To build a package, create a recipe.  See for many example recipes, and for documentation on how to build

To upload to Binstar, create an account on  Then, install the
binstar client and login

.. code-block:: bash

   $ conda install binstar
   $ binstar login

Then, after you build your recipe

.. code-block:: bash

   $ conda build <recipe-dir>

you will be prompted to upload to binstar.

To add your Binstar 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

(replacing ``username`` 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
<!forum/conda>`_.  The source
code and issue tracker for conda are on `GitHub <>`_.



.. toctree::
   :maxdepth: 2

File Type Py Version Uploaded on Size
conda-3.0.6.tar.gz (md5) Source 2014-02-28 95KB
  • Downloads (All Versions):
  • 82 downloads in the last day
  • 511 downloads in the last week
  • 2144 downloads in the last month