argus-proof 0.2.0__tar.gz

argus_proof-0.2.0/.copier-answers.yml

@@ -0,0 +1,21 @@
+# Managed by Copier — do not edit by hand.
+# Run `copier update` in this repo to pull template changes.
+_commit: e7a0753
+_src_path: argus-pkg-template
+author: smk762
+cli_name: argus-proof
+description: 'Post-training LoRA evaluation and optimisation: generate samples from
+    a trained LoRA and score them against the curated dataset it was trained from'
+dockerfile: Dockerfile
+github_owner: smk762
+has_cli: true
+has_server: true
+image_name: argus-proof
+package_name: argus_proof
+post_test: ''
+project_name: argus-proof
+python_min: '3.11'
+ruff_pin: 0.15.16
+test_extras: dev,server,cli
+version_build_arg: false
+

argus_proof-0.2.0/.env.example

@@ -0,0 +1,46 @@
+# ── Server ───────────────────────────────────────────────────────────
+# Host port for the argus-proof FastAPI server (peer to lens :8100,
+# curator :8101, quarry :8102, forge :8103).
+PROOF_PORT=8104
+
+# ── Generation backend ───────────────────────────────────────────────
+# Which engine generates the eval grid (argus_proof.backends.get_backend).
+# Swapping this changes nothing in scoring/report code.
+#   comfyui   — a running ComfyUI instance
+#   diffusers — in-process diffusers SDXL pipeline (needs the [diffusers] extra)
+#   a1111     — an AUTOMATIC1111 / SD.Next /sdapi server
+#   remote    — a hosted/cloud endpoint that speaks the proof wire
+PROOF_BACKEND=comfyui
+
+# Local model directory (for comfyui / diffusers / a1111 — checkpoints + LoRAs
+# are resolved and SHA256-pinned into the manifest from here). GET /models lists
+# <dir>/checkpoints and <dir>/loras (the ComfyUI layout). Several roots may be
+# given PATH-style (dir1:dir2), mirroring ComfyUI's extra_model_paths trees.
+PROOF_MODELS_DIR=~/models
+
+# ComfyUI workflow template (API-format graph with $placeholders). Unset = the
+# packaged SDXL+LoRA example (argus_proof/templates/comfyui_sdxl_lora.json).
+#PROOF_WORKFLOW_TEMPLATE=/path/to/workflow.json
+
+# ── Storage ──────────────────────────────────────────────────────────
+# Where scored EvalReports live (<run_id>.json). Compose mounts a volume here.
+#ARGUS_PROOF_REPORTS_DIR=reports
+# Where generated runs land (<run_id>/ with manifest.json + images); also the
+# root GET /report/{run_id}/image/{image_id} serves from.
+#ARGUS_PROOF_RUNS_DIR=runs
+# Where curator exports are read from (GET /exports + POST /run/stream's
+# `export` field name-resolves under this root).
+#ARGUS_PROOF_EXPORTS_DIR=/data/out
+
+# Replay/demo mode (issue #45): serve stored reports read-only and 403 all live
+# GPU eval + writes — for the GPU-less public demo host. Point the two dirs above
+# at the seeded "tape" reports/runs when this is on. GET /health echoes the flag.
+#ARGUS_PROOF_READ_ONLY=1
+
+# HTTP backends — the engine's base URL.
+COMFYUI_BASE_URL=http://127.0.0.1:8188
+A1111_BASE_URL=http://127.0.0.1:7860
+
+# remote (cloud) backend — the hosted generation endpoint + its bearer token.
+PROOF_REMOTE_URL=https://your-proof-gen.example.com
+PROOF_REMOTE_API_KEY=

argus_proof-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,20 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  ci:
+    uses: smk762/argus-ci/.github/workflows/python-ci.yml@v1
+    with:
+      ruff-version: "0.15.16"
+      test-extras: "dev,server,cli"
+      post-test: "uv run --no-sync argus-proof schema --check"
+

argus_proof-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,106 @@
+name: Release to PyPI
+
+# Top-level (non-reusable) on purpose: PyPI trusted publishing cannot run inside
+# a reusable workflow. Keep this file in sync across the suite via `copier update`.
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+      - run: uv build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  test-install:
+    runs-on: ubuntu-latest
+    needs: build
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+      - name: Install wheel and smoke-test import
+        run: |
+          uv venv --python ${{ matrix.python-version }}
+          uv pip install dist/*.whl
+          uv run --no-sync python -c "import argus_proof; print(f'argus-proof {argus_proof.__version__} OK')"
+
+  publish-testpypi:
+    runs-on: ubuntu-latest
+    needs: test-install
+    environment: testpypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-pypi:
+    runs-on: ubuntu-latest
+    needs: publish-testpypi
+    environment: pypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-image:
+    runs-on: ubuntu-latest
+    needs: test-install
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # hatch-vcs reads the tag from git history
+      - uses: docker/setup-buildx-action@v3
+      - uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository_owner }}/argus-proof
+          tags: |
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=raw,value=latest
+      - uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: ./Dockerfile
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

argus_proof-0.2.0/.gitignore

@@ -0,0 +1,11 @@
+.venv/
+__pycache__/
+*.pyc
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+# hatch-vcs writes this at build time (version derived from git tags)
+src/argus_proof/_version.py
+uv.lock

argus_proof-0.2.0/Dockerfile

@@ -0,0 +1,27 @@
+# syntax=docker/dockerfile:1
+FROM python:3.11-slim
+
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
+
+WORKDIR /app
+
+# hatch-vcs derives the version from git history, so the build context must
+# include .git (keep it out of .dockerignore for this image) and the image
+# needs the git binary for setuptools-scm to read it (slim ships without it).
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends git \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY . .
+
+# Extras baked into the image. Default keeps it light; build with
+# EXTRAS="server,cli,score" for the full scorer stack (torch, insightface, …).
+ARG EXTRAS="server,cli"
+
+# pillow + imagehash ride along regardless: they power phash near-dup collapse
+# and diversity (honest group pass-rates) at negligible image cost.
+RUN uv pip install --system --no-cache ".[${EXTRAS}]" pillow imagehash
+
+EXPOSE 8104
+CMD ["argus-proof", "serve", "--port", "8104", "--cors"]
+

argus_proof-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 smk762
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

argus_proof-0.2.0/Makefile

@@ -0,0 +1,27 @@
+UV ?= uv
+
+.PHONY: help install lint format test build clean
+
+help:  ## Show this help
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-12s\033[0m %s\n", $$1, $$2}'
+
+install:  ## Create venv and install with test extras
+	$(UV) venv
+	$(UV) pip install -e ".[dev,server,cli]"
+
+lint:  ## Ruff check + format check
+	$(UV)x ruff@0.15.16 check src/ tests/
+	$(UV)x ruff@0.15.16 format --check src/ tests/
+
+format:  ## Ruff autoformat + autofix
+	$(UV)x ruff@0.15.16 format src/ tests/
+	$(UV)x ruff@0.15.16 check --fix src/ tests/
+
+test:  ## Run the test suite
+	$(UV) run --no-sync pytest --tb=short -q
+
+build:  ## Build sdist + wheel
+	$(UV) build
+
+clean:  ## Remove build + cache artifacts
+	rm -rf dist build .venv *.egg-info .pytest_cache .ruff_cache src/argus_proof/_version.py