hello-python-uv

A minimal template project demonstrating uv, an extremely fast Python package and project manager.

What is uv?

uv is a modern Python project and package manager written in Rust. It provides:

• Fast package resolution and installation – orders of magnitude faster than pip
• Unified project management – handles dependencies, virtual environments, and script execution
• Python version management – download and manage multiple Python versions
• PEP-compliant tools – supports pyproject.toml, requirements.txt, and more

Getting Started

Install uv

# On macOS, Linux or Windows (WSL)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or with Homebrew (macOS/Linux)
brew install uv

For other installation methods, see the official installation guide.

Run the Project

# Run the main script
uv run main.py

uv automatically creates a virtual environment and installs dependencies as needed.

Add Dependencies

# Add a new package
uv add package-name

# Add a development-only dependency
uv add --dev pytest

Project Structure

• pyproject.toml – Project metadata and dependencies (PEP 621)
• main.py – Example Python script
• .venv/ – Virtual environment (created automatically by uv)

Learn More

• uv Documentation
• pyproject.toml Guide
• uv Commands Reference