METADATA 8.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213
  1. Metadata-Version: 2.1
  2. Name: conda
  3. Version: 23.5.2
  4. Summary: OS-agnostic, system-level binary package manager.
  5. Project-URL: documentation, https://docs.conda.io/projects/conda/en/stable/
  6. Project-URL: repository, https://github.com/conda/conda
  7. Project-URL: changelog, https://github.com/conda/conda/blob/main/CHANGELOG.md
  8. Author-email: "Anaconda, Inc." <conda@continuum.io>
  9. License: BSD 3-Clause License
  10. Copyright (c) 2012, Anaconda, Inc.
  11. All rights reserved.
  12. Redistribution and use in source and binary forms, with or without
  13. modification, are permitted provided that the following conditions are met:
  14. * Redistributions of source code must retain the above copyright
  15. notice, this list of conditions and the following disclaimer.
  16. * Redistributions in binary form must reproduce the above copyright
  17. notice, this list of conditions and the following disclaimer in the
  18. documentation and/or other materials provided with the distribution.
  19. * Neither the name of the copyright holder nor the names of its
  20. contributors may be used to endorse or promote products
  21. derived from this software without specific prior written permission.
  22. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
  23. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  24. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  25. DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY
  26. DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  27. (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  28. LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  29. ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  30. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  31. SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32. ---
  33. Conda incorporates the following libraries into its distributed code:
  34. * appdirs, licensed as MIT
  35. * auxlib, licensed as ISC
  36. * boltons, licensed as BSD-3-Clause
  37. * py-cpuinfo, licensed as MIT
  38. * distro, licensed as Apache-2.0
  39. * frozendict, license as LGPL-3.0
  40. * toolz, licensed as BSD-3-Clause
  41. * tqdm, licensed as MIT
  42. License-File: AUTHORS.md
  43. License-File: LICENSE
  44. Classifier: Development Status :: 5 - Production/Stable
  45. Classifier: Intended Audience :: Developers
  46. Classifier: License :: OSI Approved :: BSD License
  47. Classifier: Operating System :: OS Independent
  48. Classifier: Programming Language :: Python :: 3
  49. Classifier: Programming Language :: Python :: 3 :: Only
  50. Classifier: Programming Language :: Python :: 3.8
  51. Classifier: Programming Language :: Python :: 3.9
  52. Classifier: Programming Language :: Python :: 3.10
  53. Classifier: Programming Language :: Python :: 3.11
  54. Classifier: Programming Language :: Python :: Implementation :: CPython
  55. Classifier: Programming Language :: Python :: Implementation :: PyPy
  56. Requires-Python: >=3.8
  57. Requires-Dist: boltons>=23.0.0
  58. Requires-Dist: conda-package-handling>=1.3.0
  59. Requires-Dist: jsonpatch>=1.32
  60. Requires-Dist: menuinst<2,>=1.4.11; platform_system == 'Windows'
  61. Requires-Dist: packaging
  62. Requires-Dist: pluggy>=1.0.0
  63. Requires-Dist: pycosat>=0.6.3
  64. Requires-Dist: pyopenssl>=16.2.0
  65. Requires-Dist: requests<3,>=2.18.4
  66. Requires-Dist: ruamel-yaml<0.18,>=0.11.14
  67. Requires-Dist: setuptools>=31.0.1
  68. Requires-Dist: toolz>=0.8.1
  69. Requires-Dist: tqdm>=4
  70. Description-Content-Type: text/markdown
  71. [conda-logo]: https://s3.amazonaws.com/conda-dev/conda_logo.svg
  72. [tests-badge]: https://github.com/conda/conda/actions/workflows/tests.yml/badge.svg
  73. [images-badge]: https://github.com/conda/conda/actions/workflows/images.yml/badge.svg
  74. [codecov-badge]: https://img.shields.io/codecov/c/github/conda/conda/main.svg?label=coverage
  75. [release-badge]: https://img.shields.io/github/release/conda/conda.svg
  76. [gitpod]: https://gitpod.io/button/open-in-gitpod.svg
  77. [![Conda Logo][conda-logo]](https://github.com/conda/conda)
  78. [![Tests (GitHub Actions)][tests-badge]](https://github.com/conda/conda/actions/workflows/tests.yml)
  79. [![Images (GitHub Actions)][images-badge]](https://github.com/conda/conda/actions/workflows/images.yml)
  80. [![Codecov Status][codecov-badge]](https://codecov.io/gh/conda/conda/branch/main)
  81. [![latest release version][release-badge]](https://github.com/conda/conda/releases)
  82. Conda is a cross-platform, language-agnostic binary package manager. It is the
  83. package manager used by [Anaconda](https://www.anaconda.com/distribution/) installations, but it may be
  84. used for other systems as well. Conda makes environments first-class
  85. citizens, making it easy to create independent environments even for C
  86. libraries. Conda is written entirely in Python, and is BSD licensed open
  87. source.
  88. Conda is enhanced by organizations, tools, and repositories created and managed by
  89. the amazing members of the conda community. Some of them can be found
  90. [here](https://github.com/conda/conda/wiki/Conda-Community).
  91. ## Installation
  92. Conda is a part of the [Anaconda Distribution](https://repo.anaconda.com).
  93. Use [Miniconda](https://docs.conda.io/en/latest/miniconda.html) to bootstrap a minimal installation
  94. that only includes conda and its dependencies.
  95. ## Getting Started
  96. If you install the Anaconda Distribution, you will already have hundreds of packages
  97. installed. You can see what packages are installed by running
  98. ```bash
  99. $ conda list
  100. ```
  101. to see all the packages that are available, use
  102. ```bash
  103. $ conda search
  104. ```
  105. and to install a package, use
  106. ```bash
  107. $ conda install <package-name>
  108. ```
  109. The real power of conda comes from its ability to manage environments.
  110. In conda, an environment can be thought of as a completely separate installation.
  111. Conda installs packages into environments efficiently using [hard links](https://en.wikipedia.org/wiki/Hard_link) by default when it is possible, so
  112. environments are space efficient, and take seconds to create.
  113. The default environment, which `conda` itself is installed into, is called `base`.
  114. To create another environment, use the `conda create` command.
  115. For instance, to create an environment with PyTorch, you would run:
  116. ```bash
  117. $ conda create --name ml-project pytorch
  118. ```
  119. This creates an environment called `ml-project` with the latest version of PyTorch, and its dependencies.
  120. We can now activate this environment:
  121. ```bash
  122. $ conda activate ml-project
  123. ```
  124. This puts the `bin` directory of the `ml-project` environment in the front of the `PATH`,
  125. and sets it as the default environment for all subsequent conda commands.
  126. To go back to the base environment, use
  127. ```bash
  128. $ conda deactivate
  129. ```
  130. ## Building Your Own Packages
  131. You can easily build your own packages for conda, and upload them
  132. to [anaconda.org](https://anaconda.org), a free service for hosting
  133. packages for conda, as well as other package managers.
  134. To build a package, create a recipe. Package building documentation is available
  135. [here](https://docs.conda.io/projects/conda-build/en/latest/).
  136. See [AnacondaRecipes](https://github.com/AnacondaRecipes) for the recipes that make up the Anaconda Distribution and `defaults` channel.
  137. [Conda-forge](https://conda-forge.org/feedstocks/) and [Bioconda](https://github.com/bioconda/bioconda-recipes) are community-driven conda-based distributions.
  138. To upload to anaconda.org, create an account. Then, install the
  139. anaconda-client and login
  140. ```bash
  141. $ conda install anaconda-client
  142. $ anaconda login
  143. ```
  144. Then, after you build your recipe
  145. ```bash
  146. $ conda build <recipe-dir>
  147. ```
  148. you will be prompted to upload to anaconda.org.
  149. To add your anaconda.org channel, or other's channels, to conda so
  150. that `conda install` will find and install their packages, run
  151. ```bash
  152. $ conda config --add channels https://conda.anaconda.org/username
  153. ```
  154. (replacing `username` with the username of the person whose channel you want
  155. to add).
  156. ## Getting Help
  157. - [Documentation](https://docs.conda.io/projects/conda/en/latest)
  158. - [Twitter](https://twitter.com/condaproject)
  159. - [Slack](https://conda.slack.com)
  160. - [Bug Reports/Feature Requests](https://github.com/conda/conda/issues)
  161. - [Installer/Package Issues](https://github.com/ContinuumIO/anaconda-issues/issues)
  162. - [Discourse](https://conda.discourse.group/)
  163. ## Contributing
  164. [![open in gitpod for one-click development][gitpod]](https://gitpod.io/#https://github.com/conda/conda)
  165. Contributions to conda are welcome. See the [contributing](CONTRIBUTING.md) documentation
  166. for instructions on setting up a development environment.