Metadata-Version: 2.4
Name: conda-pypi
Version: 0.10.0
Summary: Better PyPI interoperability for the conda ecosystem.
Project-URL: homepage, https://github.com/conda/conda-pypi
Author-email: Jaime Rodríguez-Guerra <jrodriguez@quansight.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.10
Requires-Dist: build
Requires-Dist: conda-index>=0.11.0
Requires-Dist: conda-package-streaming>=0.11
Requires-Dist: installer>=1.0
Requires-Dist: packaging
Requires-Dist: pip
Requires-Dist: platformdirs
Requires-Dist: unearth
Description-Content-Type: text/markdown

# conda-pypi

<p align="center">
  <img src="./docs/_static/img/logo.png" alt="conda-pypi logo"/>
</p>

Better PyPI interoperability for the conda ecosystem.

> [!IMPORTANT]
> This project is still in early stages of development. Don't use it in production (yet).
> We do welcome feedback on what the expected behaviour should have been if something doesn't work!

## Project Status

This is a **community-maintained** project under the [conda](https://github.com/conda) organization.

### Getting Help

- **Bug reports & feature requests**: [GitHub Issues](https://github.com/conda/conda-pypi/issues)
- **Real-time chat**: [conda Zulip](https://conda.zulipchat.com/)

## What is this?

The `conda-pypi` plugin improves conda's integration with the PyPI ecosystem. The most
important feature is the `conda-pypi` channel, hosted by Anaconda, which makes pure
Python pacakges from PyPi available to users natively through `conda install`.

## Using `conda-pypi`

`conda-pypi` is available in conda 26.5 or later. To update:

```bash
conda install --name base "conda>=26.5"
```

To opt in, enable the Rattler solver and add the `conda-pypi` channel:

```bash
conda config --set solver rattler
conda config --append channels conda-pypi
```

During the beta, the `conda-pypi` channel might not appear in the
Anaconda.org web UI and some commands such as `conda search` can fail because
they request classic `repodata.json` metadata. Use `conda install` or
`conda create --dry-run` to check whether the solver can use the channel.

After configuring, you can use PyPI packages alongside conda packages in
your normal conda workflows, without needing to convert PyPI's wheel files
to conda files.

## Advanced options

`conda-pypi` includes more advanced subcommand controls for working with PyPI
packages. These options are recommended for users who want to experiment with
conda and wheels and work with cutting-edge plugin features.

You can use the following commands with the `conda pypi` subcommand to do more
with the `conda-pypi` plugin:

- `conda pypi install`: Converts PyPI packages to `.conda` format for safer installation.
- `conda pypi install -e .`: Converts a path to an editable `.conda` format package.
- `conda pypi convert`: Convert PyPI packages to `.conda` format without installing them.
- `conda install` from wheel channels (experimental): channels can serve pure Python wheels directly in `repodata.json`.
- A warning when running `conda create` or `conda install` with `pip` in the environment.

## Why?

Mixing conda and PyPI is often discouraged in the conda ecosystem.
There are only a handful patterns that are safe to run. This tool
aims to provide a safer way of keeping your conda environments functional
while mixing it with PyPI dependencies. Refer to the [documentation](docs/)
for more details.

## Attribution

- This project now incorporates [conda-pupa](https://github.com/dholth/conda-pupa)
by Daniel Holth, which provides the core PyPI-to-conda conversion functionality.
- The conda-pypi platypus logo is by [James Turner](http://www.eruditebaboon.co.uk/).

## Contributing

Please refer to [`CONTRIBUTING.md`](/CONTRIBUTING.md).
