Skip to main content
Build a conda package from a Pixi package.

​
Usage

​
Description

The pixi build command builds a conda package from a workspace that contains a [package] section in its manifest. This command uses the pixi-build system to create distributable conda packages.

​
Options

​
path
The path to a directory containing a package manifest, or to a specific manifest file.Supported manifest files: package.xml, recipe.yaml, pixi.toml, pyproject.toml, or mojoproject.toml.When a directory is provided, the command will search for supported manifest files within it.
​
platform
default:"current"
The target platform to build for.
​
platform
default:"current"
The build platform to use for building.
​
path
default:"."
The output directory to place the built artifacts.
​
path
The directory to use for incremental builds artifacts.
​
boolean
Whether to clean the build directory before building.

​
Examples

​
Build current package

Build the package in the current directory:

​
Build for specific platform

Build a package for a different target platform:

​
Build with clean

Clean the build directory before building:

​
Build from specific path

Build a package from a specific manifest file:

​
How it Works

  1. Locates the workspace based on the provided path or current directory
  2. Validates the manifest ensures it contains a [package] section
  3. Resolves dependencies using the configured channels and platforms
  4. Builds the package using the appropriate build backend
  5. Outputs artifacts to the specified output directory