Guias Python com UV

Este repositório contém guias práticos para a criação de projetos Python utilizando o gerenciador de pacotes uv integrado a diferentes frameworks, como Django, FastAPI, Flask, Flet, Streamlit e Marimo.

Instalação do uv

O uv pode ser instalado em diferentes sistemas operacionais utilizando os comandos abaixo.

Linux e macOS

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

Windows

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Via Pip

pip install uv

Conteúdo

O repositório inclui os seguintes guias:

• guia_airflow_uv.md: Configuração de ambiente Apache Airflow 3.
• guia_data_science_uv.md: Projeto completo para exercícios de Ciência de Dados (Pandas, ML, SQLite).
• guia_django_uv.md: Configuração de projetos Django.
• guia_fastapi_uv.md: Configuração de APIs com FastAPI.
• guia_flask_uv.md: Configuração de projetos web e APIs simples com Flask.
• guia_flet_uv.md: Desenvolvimento de interfaces gráficas com Flet.
• guia_jupyter_uv.md: Configuração de ambiente para Ciência de Dados com Jupyter.
• guia_marimo_uv.md: Configuração de notebooks reativos com Marimo.
• guia_streamlit_uv.md: Criação de dashboards e apps com Streamlit.

Uso Básico

Cada guia fornece instruções específicas, mas o fluxo geral consiste em:

1. Inicializar o projeto: uv init nome_do_projeto
2. Adicionar dependências: uv add nome_do_pacote
3. Executar o código: uv run python main.py

Dicas Extras

Sincronizando e Exportando pacotes

Sempre que você usar o uv add, o uv vai atualizar o arquivo pyproject.toml e gerar/atualizar o documento uv.lock. Se em algum momento você precisar exportar essas dependências para um formato padrão puro do pip (geralmente útil para plataformas de CI/CD antigas ou deploy sem o uv), você pode usar:

uv pip compile pyproject.toml -o requirements.txt

---

Se algum destes guias foi útil para você, considere deixar uma ⭐ no Repositório Oficial!

Desenvolvido por Carlos Felipe Araújo (@carlosxfelipe)