Migrate From Pip to UV

Python

First install uv:

brew install uv

You can follow this doc:

• From pip to a uv project | uv

For my projects, I suppose it would be:

uv init
uv add -r requirements.in -c requirements.txt

If it didn’t work:

uv add -r requirements.in

Then I change dockerfile using this tutorial:

• Optimal Dockerfile for Python with uv | Container Builds | Depot Documentation

I don’t like to install my app, so I’ve changed it to:

FROM python:3.13-slim AS build
 
COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 
WORKDIR /app
 
ENV UV_COMPILE_BYTECODE=1 UV_LINK_MODE=copy
 
COPY uv.lock pyproject.toml ./
 
RUN --mount=type=cache,target=/root/.cache/uv \
    uv sync --no-install-project --no-dev
    
FROM python:3.13-slim AS runtime
 
ENV PATH="/app/.venv/bin:$PATH"
 
RUN groupadd -g 1001 appgroup && \
    useradd -u 1001 -g appgroup -m -d /app -s /bin/false appuser
    
WORKDIR /app
 
COPY --from=build --chown=appuser:appgroup /app .
 
USER appuser
 
ENTRYPOINT ["python", "-m", "uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

UV vs UVX

Key difference: uv manages full project environments; uvx runs tools in ephemeral environments.

.PHONY: help
help:
	@egrep -h '\s##\s' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m  %-30s\033[0m %s\n", $$1, $$2}'
	
install_all_dependency: ## install all dependencies
	uv sync
	
only_dev_dependency: ## install only dev dependencies
	uv sync --only-dev
 
.PHONY: pre-commit
pre-commit: ## run pre-commit checks
	uv run pre-commit run
	
.PHONY: run
run: ## run file
	uv run python main.py