pixi
Fast cross-platform conda package manager
TLDR
Initialize new project
SYNOPSIS
pixi command [options] [arguments]
DESCRIPTION
pixi is a fast, cross-platform package manager built on the conda ecosystem. It manages Python and native dependencies together, providing reproducible environments from a single lockfile.
Projects use pixi.toml for configuration, similar to Cargo.toml. Dependencies from conda-forge, PyPI, and custom channels can be mixed. The lockfile (pixi.lock) pins exact versions for reproducibility.
Multi-platform support generates separate lockfiles per platform, enabling the same project to work on Linux, macOS, and Windows without manual intervention.
Tasks defined in pixi.toml provide npm-like scripting. Commands like test, build, and lint are configured once and run with pixi run. Task dependencies chain commands together.
Global installations (pixi global install) work like pipx, creating isolated environments for CLI tools. This keeps development tools separate from project dependencies.
PARAMETERS
init [name]
Initialize new project with pixi.toml.add packages
Add dependencies to project.remove packages
Remove dependencies.install
Install all dependencies.run task
Run a project task.shell
Activate environment shell.task subcommand
Manage project tasks.project subcommand
Manage project configuration.global subcommand
Manage global tool installations.update
Update dependencies.list
List project dependencies.tree
Show dependency tree.info
Show project information.--dev, -d
Operate on dev dependencies.--platform PLATFORM
Target platform.--feature FEATURE
Target feature.--manifest-path PATH
Path to pixi.toml.--frozen
Use existing lockfile without updates.--locked
Require lockfile to be up to date.
CONFIGURATION
pixi.toml
Project configuration file defining dependencies, tasks, and channels.pixi.lock
Lockfile with pinned versions for reproducible environments per platform.~/.pixi/config.toml
Global configuration for default channels, authentication, and cache settings.PIXI_HOME
Override the default Pixi home directory.
CAVEATS
Newer tool, ecosystem still growing. Some conda packages may not work perfectly. Mixing PyPI and conda dependencies requires care. Large environments take time to solve. Platform-specific packages need proper feature flags.
HISTORY
pixi was created by prefix.dev (makers of mamba) and released in 2023. Written in Rust, it aims to combine the best of conda, pip, and cargo into a unified tool. It leverages the fast dependency resolver from rattler-build and integrates with the conda ecosystem while adding modern project management features.
