uv-python-workflow

name	uv-python-workflow
description	Use uv as the exclusive Python package and environment manager. Use this skill when installing packages, syncing environments, running scripts, writing Dockerfiles, or doing any Python dependency management — never pip, pip-compile, or virtualenv directly.
license	BSD-3-Clause
metadata	{"category":"python"}

uv Python Workflow

All Python dependency and environment management in this codebase uses uv exclusively.

Package management

• Add dependencies: uv add <package>
• Remove dependencies: uv remove <package>
• Install/sync the current project: uv sync
• Run a command inside the project environment: uv run <command>
• Never use pip install, pip-compile, or bare python -m venv.

Workspace layout

Projects may be organized as a uv workspace. Code locations managed by dg do not use uv workspaces — they rely on the dg workspace instead.

Docker / container images

When building a Python app inside a Docker image, create a relocatable virtual environment so it works after the image layers are assembled:

RUN uv venv --relocatable /app/.venv
RUN uv sync --frozen --no-dev

Do not mount ol-orchestrate-lib (or any shared library) as a volume at runtime. Shared libraries are installed as build-time dependencies only.

Running pre-commit and type checks

uv run pre-commit run --all-files
uv run mypy <package>