conda-broker#
conda-broker is a conda plugin and short cb command for supervising
long-running conda-adjacent services. It provides a user-visible broker
process, a private pluggy provider API, local process supervision, logs,
events, health checks, and a small Broker API for other plugins.
Use it for tools that should not restart from scratch on every conda command: package metadata caches, package recommendation workers, telemetry clients, local LLM helpers, and other opt-in services that users need to inspect and control.
Install#
Add conda-broker as a PyPI dependency with Pixi:
pixi add --pypi conda-broker
pixi run cb --help
Or, in a conda installation, use conda-pypi from the base environment:
conda activate base
conda install conda-pypi
conda pypi install conda-broker
conda broker --help
Quick Use#
cb list
cb enable package-cache
cb start package-cache
cb status
cb logs package-cache --follow
cb events
Providers expose services with the conda_broker_services() hook in the
conda_broker entry point group. Users decide which services are enabled;
discovery alone does not start a process.
Start the broker, inspect state, and stop it again.
Build a first service provider and a package cache service.
Manage services, query status from plugins, inspect logs, and configure paths.
Generated command-line reference for cb and conda broker.
Service models, hookspecs, runtime fields, and health checks.
How the broker, registry, supervisor, IPC, logs, and provider plugins fit together.