Instalando e Usando o UV - Gerenciador de Pacotes Python

O UV é um gerenciador de pacotes Python extremamente rápido e confiável, escrito em Rust. Ele serve como uma alternativa mais rápida ao pip, oferecendo melhor desempenho e recursos adicionais.

Características Principais

• Instalação de pacotes até 10x mais rápida que pip
• Resolução de dependências otimizada
• Cache inteligente de pacotes
• Compatibilidade com pip e ambientes virtuais

Instalação do UV

Existem várias maneiras de instalar o UV:

1. Usando Curl (Linux/macOS)

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Usando Pip

pip install uv

3. Usando Homebrew (macOS)

brew install uv

Comandos Básicos

Aqui estão os comandos básicos do UV para gerenciamento de projetos Python:

Criar um ambiente virtual

uv venv --python 3.12

Cria um ambiente virtual isolado para o projeto Python, utilizando o UV. venv é o subcomando para ambientes virtuais, e --python 3.12 especifica a versão do Python 3.12.

Ativar o ambiente virtual

source .venv/bin/activate

Ativa o ambiente virtual criado, permitindo que o shell utilize as versões Python e pip do ambiente virtual, isolando as dependências do projeto.

Instalar pacotes

uv pip install nome_do_pacote

Instala um pacote específico no ambiente virtual.

Instalar pacotes de um requirements.txt

uv pip install -r requirements.txt

Instala pacotes listados em um arquivo requirements.txt.

Inicializar um projeto UV

uv init

Inicializa um novo projeto Python no diretório atual, criando um arquivo pyproject.toml para gerenciar as dependências.

Adicionar dependências

uv add 

Adiciona dependências ao projeto. Exemplos:

uv add crewai

Adiciona a biblioteca crewai como dependência.

uv add crewai[tools]

Adiciona crewai e suas dependências extras de tools.

Vantagens do UV

• Velocidade superior na instalação de pacotes
• Melhor gerenciamento de dependências
• Cache mais eficiente
• Compatibilidade com projetos existentes
• Suporte a ambientes virtuais

Dicas de Uso

• Use uv pip compile requirements.in para gerar um requirements.txt otimizado
• Aproveite o cache inteligente para instalações mais rápidas
• Utilize o UV em conjunto com ambientes virtuais para melhor isolamento de projetos

Migração do Pip para UV

A migração do pip para o UV é simples, pois o UV mantém compatibilidade com os comandos do pip. Você pode continuar usando seus arquivos requirements.txt existentes e simplesmente substituir pip por uv pip nos seus comandos.

Migração do Pip para UV

A migração do pip para o UV é simples, pois o UV mantém compatibilidade com os comandos do pip. Você pode continuar usando seus arquivos requirements.txt existentes e simplesmente substituir pip por uv pip nos seus comandos.

Aprenda Mais

Para quem deseja aprender mais sobre o UV, consulte a documentação oficial: https://docs.astral.sh/uv/guides/