conda-pypi#

Welcome to the conda-pypi documentation!

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

The tool offers two main commands: conda pypi install for safer PyPI package installation with an intelligent hybrid approach, and conda pypi convert for converting PyPI packages to .conda format without installing them. The smart installation strategy ensures that explicitly requested packages come from PyPI while dependencies are sourced from conda channels when available.

conda-pypi includes full support for development workflows through editable installations with the -e flag, and can install directly from git repositories and local directories. To protect your conda environments, it automatically deploys EXTERNALLY-MANAGED files to prevent accidental pip usage that could break your environment’s integrity.

Warning

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!

🏡 Getting started

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

Quick start
💡 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
🏗️ Architecture

Technical architecture and plugin system design

Architecture
📚 CLI Reference

Complete command-line interface documentation

CLI Reference
🔧 Troubleshooting

Common issues and how to resolve them

Troubleshooting
🔧 Developer Notes

Implementation details and technical insights

Developer Notes