Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated notes about conda #1581

Open
wants to merge 9 commits into
base: main
Choose a base branch
from
9 changes: 7 additions & 2 deletions source/guides/installing-scientific-packages.rst
Original file line number Diff line number Diff line change
Expand Up @@ -134,5 +134,10 @@ native virtual environments. Conda makes environments first-class citizens,
making it easy to create independent environments even for C libraries. It is
written in Python, but is Python-agnostic. Conda manages Python itself as a
package, so that :command:`conda update python` is possible, in contrast to
pip, which only manages Python packages. Conda is available in Anaconda and
Miniconda (an easy-to-install download with just Python and conda).
pip, which only manages Python packages.

The conda package manager is available in `Anaconda <https://docs.anaconda.com/anaconda/>`_, `miniconda <https://docs.anaconda.com/miniconda/>`_, `miniforge <https://github.com/conda-forge/miniforge>`_, and `pixi <https://pixi.sh/>`_.
ChrisBarker-NOAA marked this conversation as resolved.
Show resolved Hide resolved

Conda packages are available on multiple channels on Anaconda.org, including the
default channel supported by Anaconda, Inc, and the community supported conda-forge
channel, which provides a wide variety of pre-built packages.
40 changes: 22 additions & 18 deletions source/key_projects.rst
Original file line number Diff line number Diff line change
Expand Up @@ -404,26 +404,30 @@ conda

:doc:`Docs <conda:index>`

conda is the package management tool for `Anaconda
<https://docs.anaconda.com/anaconda/>`__ Python installations.
Anaconda Python is a distribution from `Anaconda, Inc
<https://www.anaconda.com/products/individual>`__ specifically aimed at the scientific
community, and in particular on Windows where the installation of binary
extensions is often difficult.
Conda is a package, dependency, and environment management system for any language — Python, R,
Ruby, C/C++, Fortran, and more. It is written in Python and
widely used in the Python scientific computing community, due to its support for non-Python
compiled libraries and extensions. It is used as the basis of the `Anaconda
<https://docs.anaconda.com/anaconda/>`__ Python distribution from `Anaconda, Inc.specifically
ChrisBarker-NOAA marked this conversation as resolved.
Show resolved Hide resolved
aimed at the scientific community, community, but can also be used on its own, or with the
ChrisBarker-NOAA marked this conversation as resolved.
Show resolved Hide resolved
:doc:`miniconda <conda:miniconda>`, `miniforge <https://github.com/conda-forge/miniforge>`_ or
`pixi <https://pixi.sh/>`_ systems. It is available for Windows, Mac and Linux systems.

Conda is a completely separate tool from :ref:`pip`, virtualenv and wheel, but provides
many of their combined features in terms of package management, virtual environment
management and deployment of binary extensions.

Conda does not install packages from PyPI and can install only from
the official Anaconda repositories, or anaconda.org (a place for
user-contributed *conda* packages), or a local (e.g. intranet) package
server. However, note that :ref:`pip` can be installed into, and work
side-by-side with conda for managing :term:`distributions
<Distribution Package>` from PyPI. Also, `conda skeleton
<https://docs.conda.io/projects/conda-build/en/latest/user-guide/tutorials/build-pkgs-skeleton.html>`__
is a tool to make Python packages installable by conda by first
fetching them from PyPI and modifying their metadata.
many of their combined features, such as package management, virtual environment
management and deployment of binary extensions and other binary code.

Conda does not install packages from PyPI -- it can only manage packages built specifically
for conda, which can be made available on a "conda channel", such as those hosted on
`anaconda.org <https://anaconda.org/>`__ or a local (e.g. intranet) package server.
ChrisBarker-NOAA marked this conversation as resolved.
Show resolved Hide resolved
In addition to the "default" channels managed by `Anaconda, Inc. <https://www.anaconda.com/>`__, there are a wide variety of packages from the community supported
`conda-forge project <https://conda-forge.org/>`__

Note that :ref:`pip` can be installed into, and work side-by-side with conda
for managing :term:`distributions <Distribution Package>` from PyPI. It is also possible
to build conda packages from Python source packages using tools such as
`conda skeleton
<https://docs.conda.io/projects/conda-build/en/latest/user-guide/tutorials/build-pkgs-skeleton.html>`__: a tool to automatically make conda packages from Python packages available on PyPI.

.. _devpi:

Expand Down
Loading