conda-ship#
Build ready-to-run conda runtimes.
conda-ship builds an executable from a locked conda environment. On first
use, that executable installs the environment into a directory called the
managed prefix, then runs the configured command, called the delegate.
Later invocations reuse the installed environment.
Use the cs CLI to build runtimes. Choose the runtime name, delegate, package
set, channels, documentation URL, and release channel in your project.
conda-express is one downstream
distribution maintained by Jannis Leidel: it uses conda-ship to build the cx
and cxz runtimes. conda-express chooses their packages, settings, and release
channels.
Start Here#
The quickstart installs the builder, creates and
locks a small conda workspace, and builds a demo runtime. For an explanation
of each step, follow the first runtime tutorial.
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 scope.
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.