3lc-compute-plugin-yolo 0.2.0__tar.gz

3lc_compute_plugin_yolo-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+  workflow_call:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  ruff:
+    name: ruff (lint + format)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.8.15"
+
+      # Ruff runs STANDALONE (uvx): linting must not require resolving the per-plugin ML
+      # stacks (torch / timm / sam3 / ultralytics) — that would be slow and need extra
+      # indexes. Config lives in pyproject [tool.ruff]; pin matches 3lc-plugin-sdk.
+      - name: Ruff lint
+        run: uvx --from 'ruff>=0.15,<0.16' ruff check .
+
+      - name: Ruff format check
+        run: uvx --from 'ruff>=0.15,<0.16' ruff format --check .

3lc_compute_plugin_yolo-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,111 @@
+name: Release
+
+# Tag (`v*`) pushes publish to public PyPI via Trusted Publishing (GitHub OIDC, no secrets).
+# Mirrors 3lc-compute-plugin-sdk / 3lc-compute-plugins release.yml. To cut a release: bump
+# `version` in pyproject.toml AND src/tlc_plugin_yolo/plugin.toml (they move together),
+# update CHANGELOG.md, commit, then push a tag `vX.Y.Z` that matches the version.
+#
+# Manual (workflow_dispatch) runs publish build-numbered prereleases to the legacy CloudRepo
+# index (pypi.3lc.ai) — kept as a grace-period fallback; retire that job (and the CLOUDREPO_*
+# secrets/vars on the "release" environment) once nothing consumes the CloudRepo index. The
+# split deliberately keeps build-numbered versions OFF PyPI: `X.Y.Z.N` sorts above `X.Y.Z`,
+# so a prerelease build would win over the real release in `>=X.Y,<X.Y+1`-style pins.
+#
+# NOTE: `uv build --no-sources` builds the WHEEL only — it does not resolve or install the
+# heavy [yolo] extra. The wheel's metadata carries the SDK pin and the extra's dependency
+# list, resolved from their indexes at install time.
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  # Gate the release on CI (ruff lint + format). ci.yml is reusable via workflow_call.
+  test:
+    uses: ./.github/workflows/ci.yml
+    secrets: inherit
+
+  # Tag (`v*`) pushes → the real release, to public PyPI.
+  publish-pypi:
+    if: github.event_name == 'push'
+    needs: test
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      contents: read
+      id-token: write # OIDC token for PyPI Trusted Publishing
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.8.15"
+
+      - name: Verify tag matches pyproject version
+        run: |
+          PKG=$(uv version --output-format json | jq -r '.version')
+          TAG="${GITHUB_REF_NAME#v}"
+          echo "pyproject=$PKG tag=$TAG"
+          [ "$PKG" = "$TAG" ] || { echo "::error::tag $GITHUB_REF_NAME ($TAG) != pyproject version $PKG"; exit 1; }
+
+      # The version the plugin card reports comes from its manifest; a tag with a drifting
+      # manifest would ship a plugin that misreports its own release.
+      - name: Verify plugin manifest matches pyproject version
+        run: |
+          PKG=$(uv version --output-format json | jq -r '.version')
+          FAIL=0
+          for MANIFEST in src/*/plugin.toml; do
+            V=$(grep -Po '^version\s*=\s*"\K[^"]+' "$MANIFEST")
+            echo "$MANIFEST: $V"
+            [ "$V" = "$PKG" ] || { echo "::error::$MANIFEST version $V != pyproject version $PKG"; FAIL=1; }
+          done
+          exit $FAIL
+
+      # --no-sources strips [tool.uv.sources] so the released wheel never bakes in a dev
+      # index/path override (the published artifact resolves deps from PyPI).
+      - name: Build
+        run: uv build --no-sources
+
+      - name: Publish to PyPI
+        run: uv publish --trusted-publishing always
+
+  # Manual (workflow_dispatch) runs → build-numbered prereleases to the legacy CloudRepo index.
+  publish-cloudrepo-prerelease:
+    if: github.event_name == 'workflow_dispatch'
+    needs: test
+    runs-on: ubuntu-latest
+    environment: release
+    env:
+      UV_PUBLISH_URL: ${{ vars.CLOUDREPO_PUBLISH_URL }}
+      UV_PUBLISH_USERNAME: ${{ secrets.CLOUDREPO_USERNAME }}
+      UV_PUBLISH_PASSWORD: ${{ secrets.CLOUDREPO_PASSWORD }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.8.15"
+
+      - name: Verify the 'release' environment is configured
+        run: |
+          : "${UV_PUBLISH_URL:?set the CLOUDREPO_PUBLISH_URL variable on the 'release' environment}"
+          : "${UV_PUBLISH_USERNAME:?set the CLOUDREPO_USERNAME secret on the 'release' environment}"
+          : "${UV_PUBLISH_PASSWORD:?set the CLOUDREPO_PASSWORD secret on the 'release' environment}"
+
+      # A 4th version segment keeps every prerelease publish unique (CloudRepo has overwrites
+      # disabled) while sorting above the base version, so `<X.Y+1`-style pins still resolve it
+      # — unlike `.devN` (sorts below) or `+localN` (rejected on upload).
+      - name: Stamp build-numbered version
+        run: |
+          BASE=$(uv version --output-format json | jq -r '.version')
+          uv version "${BASE}.${GITHUB_RUN_NUMBER}"
+          echo "prerelease build version: ${BASE}.${GITHUB_RUN_NUMBER}"
+
+      - name: Build
+        run: uv build --no-sources
+
+      - name: Publish to CloudRepo
+        run: uv publish

3lc_compute_plugin_yolo-0.2.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+uv.lock
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.vscode/
+.idea/
+.DS_Store

3lc_compute_plugin_yolo-0.2.0/CHANGELOG.md

@@ -0,0 +1,76 @@
+# Changelog
+
+All notable changes to `3lc-compute-plugin-yolo` are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+Nothing yet.
+
+## [0.2.0] - 2026-08-19
+
+Also covers the unreleased 0.1.5 bump (#4), which was never tagged.
+
+### Added
+- The pretrained-checkpoint field uses the SDK's shared data-source picker: browse the compute
+  node's filesystem (confined to operator-configured roots) instead of typing a path blind.
+  The SDK's `/browse` route is mounted alongside the plugin's own routes (#7).
+
+### Changed
+- **Distribution moved to PyPI**: tagged releases publish `3lc-compute-plugin-yolo` to public
+  PyPI via Trusted Publishing; the CloudRepo index (pypi.3lc.ai) is no longer needed to install
+  the plugin. Manual prerelease builds keep publishing to CloudRepo for a grace period (#7).
+- The plugin SDK pin is `>=0.2.2,<0.3.0`, resolved from public PyPI (the SDK's home since
+  0.2.2) — no custom indexes remain besides the CUDA torch index (#7). Earlier steps on the
+  way: the pin was widened to `>=0.2.0,<0.3.0` (#3), and `3lc` moved to public PyPI with the
+  3.2 rust release (#5).
+- The plugin presents itself as "Ultralytics YOLO" and surfaces the Ultralytics dual-license
+  terms (AGPL-3.0 / Enterprise License) in the manifest and README (#4).
+
+### Fixed
+- Training jobs are attributed to the configured 3LC project in the generic Queue &
+  Progress panel: the run request now carries `project_name`, which the host reads from
+  the request body only — the value stored in the saved config never reached the job
+  record, so jobs were hidden from every project-filtered view (#6).
+- A `~`-prefixed pretrained-checkpoint path is expanded at ingress instead of reaching the
+  model loader literally and failing mid-job with an opaque file-not-found (#7).
+
+## [0.1.4] - 2026-08-07
+
+### Changed
+- The `[yolo]` extra requires `3lc-ultralytics>=0.4.0`.
+
+## [0.1.3] - 2026-07-03
+
+### Fixed
+- The plugin manifest version and the distribution version are bumped together, so the version
+  the plugin card reports matches the installed distribution.
+
+## [0.1.2] - 2026-07-03
+
+### Fixed
+- The CUDA torch index is applied on Windows as well as Linux, so GPU-enabled installs work on
+  Windows hosts.
+
+### Changed
+- The plugin SDK dependency is resolved from the public package index under its final name
+  `3lc-compute-plugin-sdk` (was a git pin).
+
+## [0.1.1] - 2026-07-01
+
+### Added
+- `3lc[pacmap,umap]` extras added to the `[yolo]` provision extra, so embedding visualizations
+  work out of the box.
+
+## [0.1.0] - 2026-07-01
+
+First release, extracted from the `3lc-compute-plugins` umbrella into its own repository.
+
+### Added
+- The YOLO training plugin for the 3LC compute service: fine-tune YOLO detection and
+  segmentation models on 3LC tables via the Ultralytics stack, with per-sample metrics and
+  embeddings collected to 3LC runs. GPU-classed and venv-isolated; distributed as
+  `3lc-compute-plugin-yolo`. This plugin carries the AGPL-licensed Ultralytics dependency stack
+  in its own isolated venv (the reason it lives in a standalone repository).