Skip to content

[feature] support for pixi lock and toml files#1064

Open
jpfeuffer wants to merge 6 commits into
seqeralabs:masterfrom
jpfeuffer:feat/pixi-lock-toml
Open

[feature] support for pixi lock and toml files#1064
jpfeuffer wants to merge 6 commits into
seqeralabs:masterfrom
jpfeuffer:feat/pixi-lock-toml

Conversation

@jpfeuffer

Copy link
Copy Markdown

What this adds

Two new multi-stage build templates that build containers from existing Pixi artifacts instead of re-solving a Conda definition:

  • conda/pixi-lock:v1 — builds from a provided pixi.lock via pixi install --frozen. No re-solve, so the image matches the lock byte-for-byte (fully reproducible). When no manifest is supplied, a minimal pixi.toml is reconstructed from the lock; a user-provided manifest can be passed through and used instead.
  • conda/pixi-toml:v1 — builds from a provided pixi.toml manifest.

Both support lock/manifest delivered as a remote URL or as inline file content, in Dockerfile and Singularity flavors.

How it differs from the existing Pixi support

The existing conda/pixi:v1 template builds from a Conda definition (conda.yml / package list): Pixi imports and re-solves it at build time (pixi init --import conda.yml), generating a fresh lock during the build — so resolved versions depend on when/where the build runs. The new templates build from already-resolved Pixi artifacts the user supplies, making builds reproducible and bringing native pixi.toml/pixi.lock workflows to Wave.

Base-packages peculiarity

For conda/pixi:v1, base packages (default conda-forge::procps-ng, providing the ps binary Nextflow needs) are added straight into the env via pixi add — fine, because the lock is generated during the build. For lock builds that would invalidate the frozen lock, so base packages are installed into an isolated pixi global prefix and copied into the final image, leaving the locked env unchanged. This only covers CLI tools like ps; Python-level deps (e.g. psutil) must be in the user's pixi.toml before locking.

Changes

  • New PixiLockHelper and PixiTomlHelper; ContainerHelper dispatch.
  • TemplateUtils rendering + pixi global install base-packages path.
  • 8 templates under conda-pixi-lock-v1/ and conda-pixi-toml-v1/ (Dockerfile + Singularity, file + url).
  • BuildTemplate constants and PixiOpts (manifest field).
  • Unit/controller tests.

I also have a wave-cli branch ready.

  • feat: add pixi lock file support with conda/pixi-lock:v1 template
  • add test and support for user pixi.toml with fallback to autogenerate
  • better support for pixi lock and lock/toml combinations
  • allow basepackages again but put them in global env

jpfeuffer added 5 commits May 27, 2026 15:39
- Add CONDA_PIXI_LOCK_V1 build template constant
- Create PixiLockHelper for lock file detection and dispatch
- Add Docker/Singularity templates for URL and file-based pixi lock builds
- Wire into ContainerHelper.containerFileFromRequest dispatch
- Handle pixi lock content in condaFileFromRequest (raw passthrough)
- Templates use pixi install --frozen with inline minimal pixi.toml
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants