template-python

A simple Python template repository using modern tooling with uv and pyproject.toml.

Overview

This template provides a minimal starting point for Python projects using:

• uv: Fast Python package manager and project manager
• pyproject.toml: Modern Python project configuration (PEP 518/621)
• Python 3.13+

Prerequisites

Install uv if you haven't already:

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

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

# Or via pip
pip install uv

For more installation options, see the uv documentation.

Setup

1. Clone or use this template:

   git clone <repository-url>
   cd template-python

2. Sync dependencies (creates virtual environment automatically):

   uv sync

Running the Template

Run the main script:

uv run python main.py

This will execute the simple example in main.py which prints a greeting.

Project Structure

template-python/
├── .git/                 # Git repository
├── .gitignore           # Python-specific ignore patterns
├── .python-version      # Pinned Python version (3.13)
├── pyproject.toml       # Project configuration and dependencies
├── main.py              # Main entry point
└── README.md            # This file