Switch from Poetry to uv

.claude/skills/port-pr/SKILL.md

@@ -55,7 +55,7 @@ intentionally skip.
 | `PascalCase` methods / `camelCase` locals / `_camelCase` fields | `snake_case` functions/vars |
 | `IReadOnlyList<T>` / `IDictionary<,>` / `ISet<T>` etc. | `Sequence[T]`/`list` / `Mapping`/`dict` / `Set`/`set` etc. |
 | NUnit `Assert.That(...)` | pytest plain `assert` (check neighboring test files) |
-| `AssemblyInfo`/`.csproj` `<Version>` | `pyproject.toml` `version` (poetry) |
+| `AssemblyInfo`/`.csproj` `<Version>` | `pyproject.toml` `version` |
 
 The top-level Python areas are: `annotations`, `clusterers`, `corpora`, `jobs`,
 `optimization`, `punctuation_analysis`, `scripture`, `sequence_alignment`, `statistics`,
@@ -87,12 +87,12 @@ Apply the ported changes with Edit/Write.
 Install, format, lint, type-check, and test (this is `local_check.sh`):
 
 ```bash
-poetry install
-poetry run black .
-poetry run flake8 .
-poetry run isort .
-poetry run pyright
-poetry run pytest
+uv sync --all-extras
+uv run black .
+uv run flake8 .
+uv run isort .
+uv run pyright
+uv run pytest
 ```
 
 `black` and `isort` rewrite files in place; `flake8` and `pyright` are gates that must pass

.devcontainer/devcontainer.json

@@ -66,7 +66,7 @@
 			]
 		}
 	},
-	"postStartCommand": "poetry install"
+	"postStartCommand": "uv sync"
 	// Uncomment to connect as an existing user other than the container default. More info: https://aka.ms/dev-containers-non-root.
 	// "remoteUser": "devcontainer"
 }

.devcontainer/dockerfile

@@ -1,12 +1,12 @@
 ARG PYTHON_VERSION=3.10
-ARG POETRY_VERSION=2.4.1
+ARG UV_VERSION=0.12.17
 ARG CUDA_VERSION=12.6.1-base-ubuntu24.04
 
+FROM ghcr.io/astral-sh/uv:$UV_VERSION AS uv
+
 FROM nvidia/cuda:$CUDA_VERSION
 ARG PYTHON_VERSION
-ARG POETRY_VERSION
 
-ENV POETRY_VENV=/opt/poetry-venv
 ENV PIP_DISABLE_PIP_VERSION_CHECK=on
 ENV TZ=America/New_York
 RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
@@ -29,14 +29,13 @@ RUN curl -sS https://bootstrap.pypa.io/get-pip.py | python$PYTHON_VERSION
 RUN ln -sfn /usr/bin/python${PYTHON_VERSION} /usr/bin/python3  & \
     ln -sfn /usr/bin/python${PYTHON_VERSION} /usr/bin/python
 
+COPY --from=uv /uv /uvx /bin/
+
 # Install python packages
 RUN pip install -U pip setuptools \
-    && pip install poetry==${POETRY_VERSION} black pipenv virtualenv clearml \
-    && poetry config virtualenvs.in-project true \
+    && pip install black pipenv virtualenv clearml \
     && pip install cffi
 
 COPY ./.devcontainer/clearml.conf /root/clearml.conf
 
-ENV EFLOMAL_PATH=/workspaces/machine.py/.venv/lib/python${PYTHON_VERSION}/site-packages/eflomal/bin
-
 CMD ["bash"]

.github/workflows/ci.yml

@@ -21,36 +21,28 @@ jobs:
 
     steps:
       - uses: actions/checkout@v7
-      - name: Set up Python ${{ matrix.python-version }}
-        id: setup-python
-        uses: actions/setup-python@v6
+      - name: Install uv and Python ${{ matrix.python-version }}
+        uses: astral-sh/setup-uv@v10.2.0
         with:
+          version: 0.12.17
           python-version: ${{ matrix.python-version }}
-      - name: Install Poetry
-        uses: snok/install-poetry@v1
-        with:
-          version: 2.4.1
-          virtualenvs-create: true
-          virtualenvs-in-project: true
-          installer-parallel: true
+          enable-cache: true
       - name: Install dependencies
-        run: poetry install --no-interaction --all-extras
+        run: uv sync --locked --all-extras
       - name: Lint with Black
-        run: poetry run black . --check --diff
+        run: uv run black . --check --diff
       - name: Lint with Flake8
-        run: poetry run flake8 . --statistics --show-source
+        run: uv run flake8 . --statistics --show-source
       - name: Lint with isort
-        run: poetry run isort . --check-only
+        run: uv run isort . --check-only
       - name: Setup Node for pyright
         uses: actions/setup-node@v6
         with:
           node-version: "24"
       - name: Lint with pyright
-        run: poetry run pyright
+        run: uv run pyright
       - name: Test with pytest
-        run: poetry run pytest --cov --cov-report=xml
-        env:
-          EFLOMAL_PATH: /home/runner/work/machine.py/machine.py/.venv/lib/python${{ matrix.python-version }}/site-packages/eflomal/bin
+        run: uv run pytest --cov --cov-report=xml
       - name: Upload coverage reports to Codecov
         uses: codecov/codecov-action@v7
         env:
@@ -63,27 +55,20 @@ jobs:
 
     steps:
       - uses: actions/checkout@v7
-      - name: Set up Python 3.10
-        id: setup-python
-        uses: actions/setup-python@v6
+      - name: Install uv and Python 3.10
+        uses: astral-sh/setup-uv@v10.2.0
         with:
+          version: 0.12.17
           python-version: "3.10"
-      - name: Install Poetry
-        uses: snok/install-poetry@v1
-        with:
-          version: 2.4.1
-          virtualenvs-create: true
-          virtualenvs-in-project: true
-          installer-parallel: true
       - name: Build
-        run: poetry build
+        run: uv build
       - name: Upload package
         uses: actions/upload-artifact@v7
         with:
           name: wheel
           path: dist/*.whl
       - name: Publish
         if: startsWith(github.ref, 'refs/tags/v')
-        run: |
-          poetry config pypi-token.pypi ${{ secrets.PYPI_API_TOKEN }}
-          poetry publish
+        run: uv publish
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}

.gitignore

@@ -139,6 +139,3 @@ out/
 
 # omit IDE data
 .idea/
-
-# Ignore Poetry plugins
-.poetry/

.vscode/settings.json

@@ -16,7 +16,7 @@
   "files.associations": {
     "*.SFM": "usfm"
   },
-  "black-formatter.path": ["poetry", "run", "black"],
+  "black-formatter.path": ["uv", "run", "black"],
   "isort.args": ["--profile", "black"],
   "cSpell.words": [
     "CLEARML",
@@ -26,7 +26,5 @@
     "typeshed",
     "Usfm",
     "venv"
-  ],
-  "python-envs.defaultEnvManager": "ms-python.python:poetry",
-  "python-envs.defaultPackageManager": "ms-python.python:poetry"
+  ]
 }

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022 SIL International
+Copyright (c) 2026 SIL Global
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

dockerfile

@@ -1,30 +1,18 @@
 # syntax=docker/dockerfile:1
 ARG PYTHON_VERSION=3.12
-ARG POETRY_VERSION=2.4.1
+ARG UV_VERSION=0.12.17
 
-FROM python:$PYTHON_VERSION-slim-bookworm AS builder
-ARG POETRY_VERSION
-
-ENV POETRY_HOME=/opt/poetry
-ENV POETRY_VENV=/opt/poetry-venv
-ENV POETRY_CACHE_DIR=/opt/.cache
-
-# Install poetry separated from system interpreter
-RUN python3 -m venv $POETRY_VENV \
-    && $POETRY_VENV/bin/pip install -U pip setuptools \
-    && $POETRY_VENV/bin/pip install poetry==${POETRY_VERSION}
+FROM ghcr.io/astral-sh/uv:$UV_VERSION AS uv
 
-# Add `poetry` to PATH
-ENV PATH="${PATH}:${POETRY_VENV}/bin"
+FROM python:$PYTHON_VERSION-slim-bookworm AS builder
+COPY --from=uv /uv /bin/uv
 
 WORKDIR /src
-COPY poetry.lock pyproject.toml /src/
-RUN poetry self add poetry-plugin-export
-RUN poetry export --with=gpu --all-extras --without-hashes -f requirements.txt > requirements.txt
-
+COPY uv.lock pyproject.toml /src/
+# dev dependencies are left out of the image
+RUN uv export --frozen --no-default-groups --group gpu --all-extras --no-hashes --no-emit-project -o requirements.txt
 
 FROM python:$PYTHON_VERSION-slim-bookworm
-ARG PYTHON_VERSION
 
 ENV PIP_DISABLE_PIP_VERSION_CHECK=on
 ENV TZ=America/New_York
@@ -57,6 +45,4 @@ RUN --mount=type=cache,target=/root/.cache \
 RUN python -m pip install --no-deps . && rm -r /root/*
 ENV CLEARML_AGENT_SKIP_PYTHON_ENV_INSTALL=1
 
-ENV EFLOMAL_PATH=/usr/local/lib/python${PYTHON_VERSION}/site-packages/eflomal/bin
-
 CMD ["bash"]

dockerfile.cpu_only

@@ -1,27 +1,16 @@
 # syntax=docker/dockerfile:1
 ARG PYTHON_VERSION=3.12
-ARG POETRY_VERSION=2.4.1
+ARG UV_VERSION=0.12.17
 
-FROM python:$PYTHON_VERSION-slim-bookworm AS builder
-ARG POETRY_VERSION
-
-ENV POETRY_HOME=/opt/poetry
-ENV POETRY_VENV=/opt/poetry-venv
-ENV POETRY_CACHE_DIR=/opt/.cache
-
-# Install poetry separated from system interpreter
-RUN python3 -m venv $POETRY_VENV \
-    && $POETRY_VENV/bin/pip install -U pip setuptools \
-    && $POETRY_VENV/bin/pip install poetry==${POETRY_VERSION}
+FROM ghcr.io/astral-sh/uv:$UV_VERSION AS uv
 
-# Add `poetry` to PATH
-ENV PATH="${PATH}:${POETRY_VENV}/bin"
+FROM python:$PYTHON_VERSION-slim-bookworm AS builder
+COPY --from=uv /uv /bin/uv
 
 WORKDIR /src
-COPY poetry.lock pyproject.toml /src/
-RUN poetry self add poetry-plugin-export
-RUN poetry export --with=gpu --all-extras --without-hashes -f requirements.txt > requirements.txt
-
+COPY uv.lock pyproject.toml /src/
+# dev dependencies are left out of the image
+RUN uv export --frozen --no-default-groups --group gpu --all-extras --no-hashes --no-emit-project -o requirements.txt
 
 FROM python:$PYTHON_VERSION-slim-bookworm
 WORKDIR /root
@@ -43,6 +32,4 @@ RUN --mount=type=cache,target=/root/.cache \
 RUN python -m pip install --no-deps . && rm -r /root/*
 ENV CLEARML_AGENT_SKIP_PYTHON_ENV_INSTALL=1
 
-ENV EFLOMAL_PATH=/usr/local/lib/python${PYTHON_VERSION}/site-packages/eflomal/bin
-
 CMD ["bash"]

local_check.sh

@@ -1,13 +1,13 @@
 #!/bin/bash
-poetry install
+uv sync --all-extras
 
 echo "======================= black ======================"
-poetry run black .
+uv run black .
 echo "======================= flake8 ======================"
-poetry run flake8 .
+uv run flake8 .
 echo "======================= isort ======================"
-poetry run isort .
+uv run isort .
 echo "======================= pyright ======================"
-poetry run pyright
+uv run pyright
 echo "======================= pytest ======================"
-poetry run pytest
+uv run pytest