All Python dependency and environment management in this codebase uses

uv

exclusively.

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

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 (or any shared library) as a volume at runtime. Shared libraries are installed as build-time dependencies only.