Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/prefix-dev/pixi

Package management made easy
https://github.com/prefix-dev/pixi

conda conda-environment conda-packages package-management package-manager package-manager-tool python-virtual-environment rust rust-lang

Last synced: 6 days ago
JSON representation

Package management made easy

Awesome Lists containing this project

README 

        


  

    

      

      

      banner

    

  







![License][license-badge]

[![Build Status][build-badge]][build]

[![Project Chat][chat-badge]][chat-url]

[![Pixi Badge][pixi-badge]][pixi-url]



[license-badge]: https://img.shields.io/badge/license-BSD--3--Clause-blue?style=flat-square

[build-badge]: https://img.shields.io/github/actions/workflow/status/prefix-dev/pixi/rust.yml?style=flat-square&branch=main

[build]: https://github.com/prefix-dev/pixi/actions/

[chat-badge]: https://img.shields.io/discord/1082332781146800168.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2&style=flat-square

[chat-url]: https://discord.gg/kKV8ZxyzY4

[pixi-badge]:https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json&style=flat-square

[pixi-url]: https://pixi.sh






# pixi: Package Management Made Easy



## Overview



`pixi` is a cross-platform, multi-language package manager and workflow tool built on the foundation of the conda ecosystem. It provides developers with an exceptional experience similar to popular package managers like `cargo` or `yarn`, but for any language.



Developed with ❤️ at [prefix.dev](https://prefix.dev).

[![Real-time pixi_demo](https://github.com/prefix-dev/pixi/assets/12893423/0fc8f8c8-ac13-4c14-891b-dc613f25475b)](https://asciinema.org/a/636482)



## Highlights



- Supports **multiple languages** including Python, C++, and R using Conda packages. You can find available packages on [prefix.dev](https://prefix.dev).

- Compatible with all major operating systems: Linux, Windows, macOS (including Apple Silicon).

- Always includes an up-to-date **lock file**.

- Provides a clean and simple Cargo-like **command-line interface**.

- Allows you to install tools **per-project** or **system-wide**.

- Entirely written in **Rust** and built on top of the **[rattler](https://github.com/mamba-org/rattler)** library.



## Getting Started



- ⚡ [Installation](#installation)

- ⚙️ [Examples](/examples)

- 📚 [Documentation](https://pixi.sh/)

- 😍 [Contributing](#contributing)

- 🔨 [Built using Pixi](#built-using-pixi)

- 🚀 [GitHub Action](https://github.com/prefix-dev/setup-pixi)



## Status



Pixi is ready for production!

We are working hard to keep file-format changes compatible with the previous

versions so that you can rely on pixi with peace of mind.



Some notable features we envision for upcoming releases are:



- **Build and publish** your project as a Conda package.

- Support for **dependencies from source**.

- More powerful "global installation" of packages towards a deterministic setup of global packages on multiple machines.



## Installation



`pixi` can be installed on macOS, Linux, and Windows. The provided scripts will automatically download the latest version of `pixi`, extract it, and move the `pixi` binary to `~/.pixi/bin`. If this directory does not exist, the script will create it.



### macOS and Linux



To install Pixi on macOS and Linux, open a terminal and run the following command:



```bash

curl -fsSL https://pixi.sh/install.sh | bash

# or with brew

brew install pixi

```



The script will also update your ~/.bash_profile to include ~/.pixi/bin in your PATH, allowing you to invoke the pixi command from anywhere.

You might need to restart your terminal or source your shell for the changes to take effect.



Starting with macOS Catalina [zsh is the default login shell and interactive shell](https://support.apple.com/en-us/102360). Therefore, you might want to use `zsh` instead of `bash` in the install command:



```zsh

curl -fsSL https://pixi.sh/install.sh | zsh

```



The script will also update your ~/.zshrc to include ~/.pixi/bin in your PATH, allowing you to invoke the pixi command from anywhere.



### Windows



To install Pixi on Windows, open a PowerShell terminal (you may need to run it as an administrator) and run the following command:



```powershell

iwr -useb https://pixi.sh/install.ps1 | iex

```



The script will inform you once the installation is successful and add the ~/.pixi/bin directory to your PATH, which will allow you to run the pixi command from any location.

Or with `winget`



```shell

winget install prefix-dev.pixi

```



### Autocompletion



To get autocompletion follow the instructions for your shell.

Afterwards, restart the shell or source the shell config file.



#### Bash (default on most Linux systems)



```bash

echo 'eval "$(pixi completion --shell bash)"' >> ~/.bashrc

```

#### Zsh (default on macOS)



```zsh

echo 'eval "$(pixi completion --shell zsh)"' >> ~/.zshrc

```



#### PowerShell (pre-installed on all Windows systems)



```pwsh

Add-Content -Path $PROFILE -Value '(& pixi completion --shell powershell) | Out-String | Invoke-Expression'

```



If this fails with "Failure because no profile file exists", make sure your profile file exists.

If not, create it with:



```PowerShell

New-Item -Path $PROFILE -ItemType File -Force

```



#### Fish



```fish

echo 'pixi completion --shell fish | source' >> ~/.config/fish/config.fish

```



#### Nushell



Add the following to the end of your Nushell env file (find it by running `$nu.env-path` in Nushell):



```nushell

mkdir ~/.cache/pixi

pixi completion --shell nushell | save -f ~/.cache/pixi/completions.nu

```



And add the following to the end of your Nushell configuration (find it by running `$nu.config-path`):



```nushell

use ~/.cache/pixi/completions.nu *

```



#### Elvish



```elv

echo 'eval (pixi completion --shell elvish | slurp)' >> ~/.elvish/rc.elv

```



### Distro Packages



[![Packaging status](https://repology.org/badge/vertical-allrepos/pixi.svg)](https://repology.org/project/pixi/versions)



#### Arch Linux



You can install `pixi` from the [extra repository](https://archlinux.org/packages/extra/x86_64/pixi/) using [pacman](https://wiki.archlinux.org/title/Pacman):



```shell

pacman -S pixi

```



#### Alpine Linux



`pixi` is available for [Alpine Edge](https://pkgs.alpinelinux.org/packages?name=pixi&branch=edge). It can be installed via [apk](https://wiki.alpinelinux.org/wiki/Alpine_Package_Keeper) after enabling the [testing repository](https://wiki.alpinelinux.org/wiki/Repositories).



```shell

apk add pixi

```



## Build/install from source



`pixi` is 100% written in Rust and therefore it can be installed, built and tested with cargo.

To start using `pixi` from a source build run:



```shell

cargo install --locked --git https://github.com/prefix-dev/pixi.git pixi

```



We don't publish to `crates.io` anymore, so you need to install it from the repository.

The reason for this is that we depend on some unpublished crates which disallows us to publish to `crates.io`.



or when you want to make changes use:



```shell

cargo build

cargo test

```



If you have any issues building because of the dependency on `rattler` checkout

it's [compile steps](https://github.com/mamba-org/rattler/tree/main#give-it-a-try)



## Uninstall



To uninstall the pixi binary should be removed.

Delete `pixi` from the `$PIXI_DIR` which is default to `~/.pixi/bin/pixi`



So on Linux its:



```shell

rm ~/.pixi/bin/pixi

```



and on Windows:



```shell

$PIXI_BIN = "$Env:LocalAppData\pixi\bin\pixi"; Remove-Item -Path $PIXI_BIN

```



After this command you can still use the tools you installed with `pixi`.

To remove these as well just remove the whole `~/.pixi` directory and remove the directory from your path.



# Usage



The cli looks as follows:



```bash

➜ pixi

A package management and workflow tool



Usage: pixi [OPTIONS] 



Commands:

  completion  Generates a completion script for a shell

  init        Creates a new project

  add         Adds a dependency to the project

  run         Runs task in project

  shell       Start a shell in the pixi environment of the project

  global      Global is the main entry point for the part of pixi that executes on the global(system) level

  auth        Login to prefix.dev or anaconda.org servers to access private channels

  install     Install all dependencies

  task        Command management in project

  info        Information about the system and project

  upload      Upload a package to a prefix.dev channel

  search      Search a package, output will list the latest version of package

  project

  help        Print this message or the help of the given subcommand(s)



Options:

  -v, --verbose...     More output per occurrence

  -q, --quiet...       Less output per occurrence

      --color   Whether the log needs to be colored [default: auto] [possible values: always, never, auto]

  -h, --help           Print help

  -V, --version        Print version



```



## Creating a pixi project



Initialize a new project and navigate to the project directory



```

pixi init myproject

cd myproject

```



Add the dependencies you want to use



```

pixi add cowpy

```



Run the installed package in its environment



```bash

pixi run cowpy "Thanks for using pixi"

```



Activate a shell in the environment



```shell

pixi shell

cowpy "Thanks for using pixi"

exit

```



## Installing a conda package globally



You can also globally install conda packages into their own environment.

This behavior is similar to [`pipx`](https://github.com/pypa/pipx) or [`condax`](https://github.com/mariusvniekerk/condax).



```bash

pixi global install cowpy

```



## Use in GitHub Actions



You can use pixi in GitHub Actions to install dependencies and run commands.

It supports automatic caching of your environments.



```yml

- uses: prefix-dev/[email protected]

- run: pixi exec cowpy "Thanks for using pixi"

```



See the [documentation](https://pixi.sh/latest/advanced/github_actions) for more details.






## Contributing 😍



We would absolutely love for you to contribute to `pixi`!

Whether you want to start an issue, fix a bug you encountered, or suggest an

improvement, every contribution is greatly appreciated.



If you're just getting started with our project or stepping into the Rust

ecosystem for the first time, we've got your back!

We recommend beginning with issues labeled as `good first issue`.

These are carefully chosen tasks that provide a smooth entry point into

contributing.These issues are typically more straightforward and are a great way

to get familiar with the project.



Got questions or ideas, or just want to chat? Join our lively conversations on

Discord.

We're very active and would be happy to welcome you to our

community. [Join our discord server today!][chat-url]






## Built using pixi



To see what's being built with `pixi` check out the [Community](/docs/Community.md) page.