conda-ship

Build ready-to-run conda runtimes.

conda-ship is a generic builder for single-binary conda runtimes. It installs the cs CLI, but it does not ship a first-party distribution. Downstream projects choose the runtime name, delegate executable, package set, channels, documentation URL, and release channel.

conda-express is one downstream distribution maintained by Jannis Leidel: it uses conda-ship to build the cx and cxz runtimes. conda-ship owns the reusable builder; conda-express owns the product defaults and release channels for cx.

Start Here

If you are new to conda-ship, start with the quickstart. It creates a small conda workspace, locks it, and stages a demo runtime:

conda install --name base -c conda-forge conda-pypi
conda create -n cs-demo -c conda-forge python pip conda-workspaces
conda activate cs-demo
conda pypi install conda-ship
mkdir demo-runtime
cd demo-runtime

Then follow the quickstart.

Choose A Path

• New to conda-ship: follow the first runtime tutorial.

• Building a downstream runtime: use customize a runtime, then check the exact fields in the configuration reference.

• Shipping from CI: start with build in GitHub Actions.

• Choosing names or release files: read runtime and artifact names and artifacts.

• Unsure what belongs here versus downstream: read project boundaries.

• Building an orchestrator for multiple locked runtimes: read Fleet concepts and the Fleet API reference.

Scope

conda-ship builds runtimes from solved conda environments. It does not choose package sets, reserve downstream runtime names, publish a first-party runtime, or generate operating-system installers.