Pixi — Gerenciador de Ambientes Python

🚀

Projeto e Ambiente

pixi init

pixi init meu-projeto

Cria um novo projeto com pixi.toml na pasta indicada.

pixi init .

Inicializa o pixi no diretório atual já existente.

pixi install

Instala todas as dependências definidas no pixi.toml.

pixi shell

Ativa o ambiente do projeto no shell atual.

pixi clean

Remove o ambiente local (.pixi/) e limpa o cache do projeto.

📦

Gerenciar Pacotes

pixi add

pixi add numpy pandas

Adiciona pacote(s) conda-forge ao projeto e instala.

add --pypi

pixi add --pypi flask

Adiciona pacote direto do PyPI (pip). Requer Python instalado.

add --dev

pixi add --dev pytest black

Adiciona dependência apenas para desenvolvimento.

pixi remove

pixi remove numpy

Remove pacote do projeto e atualiza o pixi.lock.

pixi update

Atualiza todos os pacotes para as versões mais recentes compatíveis.

▶️

Executar Comandos e Tarefas

pixi run

pixi run python script.py

Executa um comando dentro do ambiente do projeto.

run python

pixi run python

Abre o interpretador Python do ambiente isolado.

task add

pixi task add test 'pytest .'

Cria um atalho de tarefa reutilizável no pixi.toml.

run test

pixi run test

Executa uma tarefa definida no projeto (ex: rodar testes).

pixi exec

pixi exec cowpy "olá"

Executa pacote em ambiente temporário sem instalar no projeto.

🔍

Informações e Diagnóstico

pixi info

Exibe sistema, versão do pixi, plataforma e ambientes do projeto.

pixi list

Lista todos os pacotes instalados no ambiente atual com versões.

pixi -V

pixi --version

Mostra a versão instalada do pixi.

global add

pixi global install ruff

Instala ferramenta globalmente (sem precisar de projeto).

pixi self-update

Atualiza o próprio pixi para a versão mais recente.

📄 pixi.toml

Arquivo de configuração do projeto. Define dependências, tarefas e canais. Versionar no git junto com pixi.lock.

🔒 pixi.lock

Arquivo de lock gerado automaticamente com versões exatas. Garante reprodução idêntica do ambiente em qualquer máquina.

📡 Canais

Por padrão usa conda-forge. Use --pypi para pacotes do PyPI. Canais definem de onde vêm os pacotes.

🆘 Ajuda

Use pixi --help ou pixi <cmd> --help para ver opções. Docs em pixi.sh.