prefix-dev/setup-pixi
Install the pixi package manager
View on GitHubTrust Signals
- Scorecard Score
- Scorecard 4–6scored Jul 6, 2026
- Maintenance Recency
- Activelast commit Jul 2, 2026
- License
- BSD
Pinned Snippet
uses: prefix-dev/setup-pixi@a09b6247153796b190642a2b53fac4241043cf6f # v0.10.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| pixi-version | Version of pixi to install | — | — |
| pixi-url | URL of pixi to install. Can be a Handlebars template receiving `version`, `latest`, and `pixiFile` as variables. | — | — |
| pixi-url-headers | Headers to use when fetching the pixi binary from `pixi-url`. Should be a JSON string. | — | — |
| log-level | Log level for the pixi CLI. One of `q`, `default`, `v`, `vv`, or `vvv`. | — | — |
| manifest-path | Path to the manifest file (i.e., `pixi.toml`) to use for the pixi CLI. Defaults to `pixi.toml`. | — | — |
| working-directory | Working directory to use for pixi commands. If specified, pixi will look for manifest files (pixi.toml or pyproject.toml) in this directory instead of the repository root. Useful for monorepos where pixi projects are in subdirectories. | — | — |
| run-install | Whether to run `pixi install` after installing pixi. Defaults to `true`. | — | — |
| environments | A space-separated list of environments to install. If not specified, only the default environment is installed. | — | — |
| global-environments | A newline-separated list of packages to install globally with `pixi global install`. | — | — |
| activate-environment | If the installed environment should be "activated" for the current job, modifying `$GITHUB_ENV` and `$GITHUB_PATH`. If more than one environment is specified in `environments`, this must be the name of the environment. Defaults to `false`. Requires at least pixi v0.21.0. | — | — |
| locked | Whether to use `pixi install --locked`. Defaults to `true` when the lockfile is present, otherwise `false`. | — | — |
| frozen | Whether to use `pixi install --frozen`. Defaults to `false`. | — | — |
| cache | Whether to cache the pixi environment. Defaults to `true`. Only works if `pixi.lock` is present. | — | — |
| global-cache | Whether to cache the global environment(s). Defaults to `false`. As there is no lockfile for global environment, the global cache will expire at the end of every month, to ensure it does not go stale. | — | — |
| cache-key | Cache key prefix to use for caching the pixi environment. Defaults to `pixi-`. The full cache key is `<cache-key><conda-arch>-<sha-256-of-pixi-lock>`. | — | — |
| global-cache-key | Cache key prefix to use for caching the global environments. Defaults to `pixi-global-`. The full cache key is `<global-cache-key><conda-arch>-<sha-256-of-global-environments>`. | — | — |
| cache-write | Whether to write to the cache or only read from it. Defaults to `true`. Applies to both project and global caches as the case may be. | — | — |
| pixi-bin-path | Path to the pixi binary to use. Defaults to `~/.pixi/bin/pixi`. | — | — |
| auth-host | Host to use for authentication. If not set, pixi is not authenticating. Requires `auth-token` or `auth-conda-token` or `auth-username` and `auth-password` to be set. See https://pixi.prefix.dev/latest/deployment/authentication/ | — | — |
| auth-token | Token to use for authentication. | — | — |
| auth-username | Username to use for authentication. | — | — |
| auth-password | Password to use for authentication. | — | — |
| auth-conda-token | Conda token to use for authentication. | — | — |
| auth-s3-access-key-id | Access key ID to use for S3 authentication. | — | — |
| auth-s3-secret-access-key | Secret access key to use for S3 authentication. | — | — |
| auth-s3-session-token | Session token to use for S3 authentication. | — | — |
| persist-credentials | Whether to keep the credentials configured by `auth-host` available to subsequent workflow steps. Defaults to `true`. If set to `false`, the action runs `pixi auth logout <auth-host>` after install, so that later steps cannot reach the private channel anymore. Requires `auth-host`. | — | — |
| pypi-keyring-provider | Specifies whether to use keyring to look up credentials for PyPI. options: disabled, subprocess | — | — |
| post-cleanup | If the action should clean up after itself. Defaults to `false`. If `true`, the pixi environment, the pixi binary and the rattler files in ~/.rattler and ~/.cache/rattler are removed. | — | — |
Outputs
no outputs