iil-gpufw

Schmaler HTTP-Client des GPU-Lease-Arbiters (illustration-hub) — ADR-296 §4.5, Auftrag platform#2020.

Normative Quelle ist der HTTP-Vertrag, nicht dieses Paket: illustration-hub/docs/api/gpu-lease-vertrag.md (v0). Strategie (Vorrang, Karenz, Räum-Reihenfolge) bleibt serverseitig. Keine Laufzeit-Dependencies, kein Django-Import; Config wird injiziert.

Nutzung

from gpufw import ArbiterConfig, interaktive_lease, batch_lease

config = ArbiterConfig.aus_env()  # GPU_ARBITER_URL, GPU_ARBITER_TOKEN, CF_ACCESS_*

# Interaktiv: ein Mensch wartet — BELEGT heisst ehrlich abbrechen.
with interaktive_lease(config, verbraucher="mein-cli", zweck="render x") as zusage:
    if not zusage.gewaehrt:
        raise RuntimeError(zusage.als_fehlertext())  # traegt den belegt-Marker
    arbeit()

# Batch: BELEGT heisst warten (Aufrufer-Sache); Verdraengung meldet sich
# ueber das Event — zwischen Arbeitsschritten pruefen und pausieren.
with batch_lease(config, verbraucher="text-batch", job_id="job-42") as zusage:
    if not zusage.gewaehrt:
        warte_und_versuche_spaeter(zusage.grund)
    else:
        for kapitel in arbeit_in_schritten():
            if zusage.verdraengt.is_set():
                pausieren()  # interaktive Lane hat Vorrang
                break
            verarbeite(kapitel)

Client-Pflichten aus dem Vertrag (fail-open, kein Bezahl-Rückfall bei BELEGT, immer freigeben, tolerant lesen) sind in gpufw.lease umgesetzt und getestet (make test, Stub-Arbiter, kein Netz).

Grenzen (ehrlich)

• Fail-open heisst: ohne erreichbaren Arbiter läuft der Konsument ohne Koordination weiter (degradiert=True + Log). Das ist Vertragsabsicht — kein Handgriff darf Render/Song/Text verhindern.
• GRANTED ist ein Absichts-Register, keine Karten-Wahrheit: Ollama-Einzelcalls sind lease-frei (§4.2 Nr. 7), VRAM kann trotzdem belegt sein.

Release

Über den etablierten /release-Weg (ADR-084-Muster). PyPI-Publish ist ein eigener Freigabe-Schritt des Owners.