nietarne/alpine-uv repository overview

⁠alpine-uv

A lightweight, minimal base image built on Alpine with uv⁠ pre-installed — the blazing-fast Python package and project manager from Astral⁠.

No Python runtime is bundled. uv handles Python installation, virtual environments, and dependency management entirely on its own.

⁠What's included

⁠Usage

⁠Interactive shell

docker run --rm -it nietarne/alpine-uv

⁠Install Python and run a script

docker run --rm -v $(pwd):/project nietarne/alpine-uv \
  uv run --python 3.12 script.py

⁠Install dependencies from a pyproject.toml

docker run --rm -v $(pwd):/project nietarne/alpine-uv \
  uv sync

⁠Run a one-off tool with uvx

docker run --rm nietarne/alpine-uv uvx ruff check .

⁠Working directory

The default WORKDIR is /project. Mount your code here:

docker run --rm -v $(pwd):/project nietarne/alpine-uv uv run main.py

⁠Why uv?

• 10–100× faster than pip for installs and dependency resolution
• Single binary — no Python needed to bootstrap
• Manages Python versions, virtual envs, and packages in one tool
• Drop-in replacement for pip, pip-tools, virtualenv, and more

⁠License

MIT