Basic usageTaking your first steps with pixi

Make sure that you have pixi installed, this should print the help function, check the installation manual if it doesn't.


Initialize a new project and navigate to the project directory.

pixi init pixi-hello-world
cd pixi-hello-world

Add the dependencies you would like to use.

pixi add python

Create a file named in the directory and paste the following code into the file.
def hello():
    print("Hello World, to the new revolution in package management.")
if __name__ == "__main__":

Run the code inside the environment.

pixi run python

You can also put this run command in a task.

pixi task add hello python

After adding the task, you can run the task using its name.

pixi run hello

Use the shell command to activate the environment and start a new shell in there.

pixi shell

You've just learned the basic features of pixi:

  • adding a dependency.
  • adding a task, and executing it.
  • running a program. Feel free to play around with what you just learned like adding more tasks, dependencies or code. If you want to learn more checkout out our in-depth documentation

Happy coding!

Use pixi as an installation tool

Use pixi to install tools on your machine.

Some notable examples:

# Awesome cross shell prompt, huge tip when using pixi!
pixi global install starship
# Want to try a different shell?
pixi global install fish
# Install other tools
pixi global install rattler-build
# Install a linter you want to use in multiple projects.
pixi global install ruff