Skip to main content

Crate logit_loom_models

Crate logit_loom_models 

Source
Expand description

§Optional model profiles

Logit Loom does not redistribute model weights. This directory contains an exact, machine-checked acquisition catalog for three maintained experiment profiles:

ProfileIntended roleExact downloadCurrent integration status
qwen3-0.6b-q8-0Small text mechanics609.8 MiBFirst-class; retained Vulkan acceptance passed
minit2i-b16Small direct-RGB image mechanics3.88 GiBFirst-class; retained Vulkan acceptance passed
krea-2-turboAdvanced latent image mechanics12.36 GiBFirst-class; retained Vulkan acceptance passed

“Catalogued” means the repository pins exact upstream commits, file names, byte counts, weight digests, license locations, and local layout. It does not mean that a model-backed acceptance run has passed. That stronger status requires the adapter, opt-in accelerator execution, and captured mechanical receipts described in the model integration plan. The retained Qwen, MiniT2I, and Krea reports passed that execution gate and their catalog entries are first-class. The checker requires every profile that claims passed acceptance to have a matching retained passed report.

§Inspect and acquire

The repository-local command uses the current hf CLI. It never accepts a token on the command line; normal Hugging Face authentication, including HF_TOKEN, remains the CLI’s responsibility.

cargo run --quiet -p logit-loom-xtask -- models check
cargo run --quiet -p logit-loom-xtask -- models list
cargo run --quiet -p logit-loom-xtask -- models fetch \
  qwen3-0.6b-q8-0 --dir /path/to/model-store --dry-run
cargo run --quiet -p logit-loom-xtask -- models fetch \
  qwen3-0.6b-q8-0 --dir /path/to/model-store
cargo run --quiet -p logit-loom-xtask -- models verify \
  qwen3-0.6b-q8-0 --dir /path/to/model-store
cargo run --quiet -p logit-loom-xtask -- models verify-artifact krea-2-turbo \
  krea-2-turbo-q6-k TURBO/Krea-2-Turbo-Q6_K.gguf \
  --path /path/to/an/existing/Krea-2-Turbo-Q6_K.gguf

--dry-run validates the catalog and prints exact hf download commands. It does not invoke hf or create a directory. A real fetch downloads only the listed files at the pinned 40-character revision, then verifies every byte count and every available SHA-256 digest. An interrupted fetch can be resumed by repeating the same command. The destination must resolve outside the repository checkout so model artifacts cannot accidentally enter a release.

verify-artifact is the no-network path for a file already managed by another local model store. It applies the same byte-count and SHA-256 checks and emits a path-free JSON receipt.

The retained acquisition report in reports/acquisition-2026-07-25.json uses a bounded, versioned Rust contract. It records the hf CLI version, available filesystem bytes, catalog and verified artifact bytes, and exact path-free receipts. All three profiles are fully verified there. Krea uses the mixed acquisition method because its three runtime components were verified across a repository fetch and a caller-managed model store rather than one shared directory.

Artifacts are placed under <destination>/<profile>/<source>/. For example, the text GGUF is:

<destination>/qwen3-0.6b-q8-0/model/Qwen3-0.6B-Q8_0.gguf

Krea 2 Turbo acquisition verifies only the declared executable artifacts:

cargo run --quiet -p logit-loom-xtask -- models fetch krea-2-turbo \
  --dir /path/to/model-store

The advanced profile uses a pinned Q6_K diffusion GGUF, a pinned Q4_K_M Qwen3-VL text encoder, and the pinned Wan 2.1 VAE expected by the maintained stable-diffusion.cpp integration. Upstream legal documents may be retained as inert source content; they are not catalogued artifacts, runtime inputs, or acceptance gates. Quantization changes storage and runtime mechanics; this catalog does not make a quality comparison with the original Diffusers weights.

§Trust and execution boundary

  • No fetch runs during tests, CI, packaging, or documentation builds.
  • The catalog permits only exact file paths and commit hashes; wildcard downloads are not used.
  • Weight files require SHA-256 identities. Git-backed configuration files are bound by exact repository revision and byte count.
  • Remote model code is forbidden. In particular, MiniT2I’s upstream custom Python pipeline is not downloaded or executed by this tooling. The maintained adapter uses the reviewed, pinned stable-diffusion.cpp companion described in ADR 0001.
  • Model files remain untrusted inputs to native or tensor runtimes. A matching digest establishes artifact identity, not safety, quality, or efficacy.
  • Model and dependency licenses remain upstream terms. The Logit Loom dual license does not relicense them.

Structs§

AcquisitionReport
A path-free record of one model-acquisition verification session.
ArtifactFile
One exact file in an acquisition source.
ArtifactReceipt
Serializable evidence that one exact local artifact was verified.
Catalog
One validated model acquisition catalog.
PendingArtifact
One exact catalog artifact that was deliberately not verified.
Profile
One optional model and its exact acquisition contract.
ProfileAcquisition
One profile’s path-free acquisition evidence.
Source
One immutable repository source.
VerifiedArtifact
A verified artifact and its caller-local path.

Enums§

AcceptanceStatus
Checked-in model-backed acceptance status.
AcquisitionMethod
How the verified files reached their caller-managed store.
AcquisitionReportError
Acquisition-report parsing or invariant failure.
AcquisitionStatus
Completeness of one profile acquisition.
AdapterTarget
Maintained adapter family.
ArtifactError
Local artifact verification failure.
CatalogError
Catalog parsing or invariant failure.
IntegrationStatus
Checked-in integration status.
Modality
Model modality.
PendingReason
Why an acquisition report did not verify an exact artifact.
RemoteCodePolicy
Policy for executable code in remote model repositories.
Role
Intended profile complexity.

Constants§

CATALOG_IDENTITY_DOMAIN
Identity domain for the interpretation of the embedded catalog.
CATALOG_SCHEMA_VERSION
Current serialized catalog schema.
QWEN3_SMALL_ARTIFACT_PATH
Source-relative path of the small Qwen Q8_0 GGUF.
QWEN3_SMALL_PROFILE_ID
Stable ID of the small default Qwen text profile.
QWEN3_SMALL_SOURCE_ID
Source ID containing the small Qwen GGUF.