conda-pypi#

Welcome to the conda-pypi documentation!

conda-pypi provides better PyPI interoperability for the conda ecosystem. It allows you to safely install Python distribution packages in conda environments by converting them to conda format when possible, while falling back to traditional pip installation when needed.

The tool is available in conda versions 26.5 and newer. When configured with the conda-pypi channel (hosted by Anaconda) and the Rattler solver, the tool makes pure Python packages from PyPI available through the conda install command, with no extra conversion needed.

The tool also offers advanced commands: conda pypi convert for converting Python projects to .conda format without installing them, and conda pypi index for indexing a local directory of .whl files to create a local conda channel.

conda pypi install is pending deprecation and will be removed in version 27.9. It remains useful for editable installs of local project directories with the -e flag and for fetching wheels from a custom package index with --index-url.

conda-pypi also installs EXTERNALLY-MANAGED marker files when you install the plugin, discouraging direct pip use that can destabilize conda-managed environments.

🏡 Getting started

New to conda-pypi? Start here to learn the essentials

Quickstart
💡 Motivation and vision

Read about why conda-pypi exists and when you should use it

Motivation and vision
🍱 Features

Overview of what conda-pypi can do for you

Features
📚 Commands

Complete command-line interface documentation

Commands
🔧 Troubleshooting

Common issues and how to resolve them

Troubleshooting
👩‍💻 Developer Guide

Architecture, testing, and contribution guidelines

Developer guide