Installation¶

This page covers all supported installation methods for template-python.

Requirements¶

Before installing, ensure your system meets the following prerequisites:

Standard Installation¶

If you need to install the package directly into an environment (e.g., for local development or testing), use pip or uv:

```bash
pip install template_python
```

```bash
uv pip install template_python
```

Verify the Installation¶

After installation, you can confirm it is available in your Python environment by running:

python -c "import template_python; print(template_python.__version__)"

You should see output similar to:

0.1.0

Install from Source¶

To install the latest unreleased code directly from the repository and set up a local development environment:

git clone https://github.com/markurtz/template-python.git
cd template-python

# Sync the development environment (installs all groups and extras)
uv sync --all-groups --all-extras

# Or, optionally install specific groups/extras:
uv sync --group dev --extra some_extra

[!TIP] This is the recommended setup for contributors looking to make changes to the source code.

Docker Installation¶

A pre-built Docker image is available for containerized environments:

# Pull the latest image
docker pull ghcr.io/markurtz/template-python:latest

# Run a one-off command
docker run --rm ghcr.io/markurtz/template-python:latest python -c "import template_python; print(template_python.__version__)"

For a persistent, volume-mounted setup using Docker Compose, see the docker-compose.yml in the root of the repository.

Platform-Specific Notes¶

Python, `pip`, and `uv` work seamlessly on macOS. We recommend using `brew install uv` to get started.

Use your distribution's package manager to install Python 3.10+ (e.g., `sudo apt install python3`).

Ensure Python is added to your PATH during the Windows installer setup.

Upgrading¶

To upgrade an existing installation to the latest release:

```bash
pip install --upgrade template-python
```

```bash
uv pip install --upgrade template-python
```

Uninstalling¶

```bash
pip uninstall template-python
```

```bash
uv pip uninstall template-python
```

Troubleshooting¶

If you continue to experience issues, please visit our Support page.

Next: Quick Start →