Usage
Description
Thepixi 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
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.The target platform to build for.
The build platform to use for building.
The output directory to place the built artifacts.
The directory to use for incremental builds artifacts.
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
- Locates the workspace based on the provided path or current directory
- Validates the manifest ensures it contains a
[package]section - Resolves dependencies using the configured channels and platforms
- Builds the package using the appropriate build backend
- Outputs artifacts to the specified output directory
Related Commands
pixi upload- Upload built packages to a channelpixi init- Initialize a new pixi workspace