Lokai-Sovereign/lokai-mlf-catalog

Lokai MLF Runtime Pack Catalog

Status: public-GA candidate repo for Lokai public runtime and anonymous model-pack distribution. Generated: 2026-08-09T04:57:24Z

This repository is the Hugging Face distribution lane for Lokai public-safe model pack metadata and approved optional MLF runtime pack artifacts. It is not the GitHub product source tree, and it is not a private routing, teacher-trace, or internal operations repository.

Lokai model packs are intended to be used by the Lokai Sovereign Public Stack. They are not standalone Hugging Face Transformers, GGUF, safetensors, PyTorch, or llama.cpp releases. The pack format is Lokai MLF plus sanitized runtime metadata for the custom Lokai Rust Phase-B engine.

Current Boundary

• GitHub ships the Lokai Sovereign Public Stack: product source, lightweight web UI, setup hooks, public runtime, validators, LAN Swarm tools, public-safe seed memory, catalog metadata, and the public engine/runtime surface.
• Hugging Face hosts model catalogs, source registries, signed/checksummed pack manifests, license/provenance evidence, and optional model-pack artifacts.
• Model weights are optional runtime packs. They are not bundled into the GitHub source release.
• Users select and stage packs through the Lokai setup/model panels under public_runtime/.
• The Lokai product runtime and custom Rust engine are required to use staged Lokai MLF packs.
• Torrent mirrors may be added later for public packs that pass the same gates.

Required Runtime

• Product/runtime: Lokai Sovereign Public Stack
• Public stack URL: to be published with the public GitHub release
• Engine path: Lokai custom Rust Phase-B engine exposed to the Python/web UI runtime through the Lokai public stack
• Expected install root for packs: public_runtime/
• Expected weight root inside a staged pack: public_runtime/weights/packs/active/<model_id>/
• Standalone raw-weight use: not supported by this repo

If you only download files from this Hugging Face repo without installing the Lokai public stack, the model pack will not be usable in the intended runtime.

What A Model Pack Contains

Approved pack artifacts are zip archives whose root is public_runtime/. A pack normally contains:

• sanitized model config, sidecar, tensor map, tokenizer, and shard index files
• Lokai MLF weight shards under public_runtime/weights/packs/active/<model_id>/
• a pack contents manifest with per-file SHA-256 checksums
• a pack manifest with archive checksum, size, upstream model reference, license evidence, and runtime requirement metadata

Pack manifests are designed so the Lokai installer can verify the artifact before making a model selectable.

What This Repo May Contain

• README.md
• public-safe catalog metadata, for example catalog/trusted_model_catalog.json
• public-safe source registry metadata, for example catalog/model_source_registry.json
• signed/checksummed pack manifests
• checksums
• license/provenance files
• optional Lokai MLF model-pack artifacts only when redistribution is allowed by the upstream license and an explicit release gate approves them

What This Repo Must Not Contain

• private routing geometry
• private coordinate maps, overlap graphs, or mind-selection internals
• private prompts, vault data, teacher traces, teacher caches, run logs, or adapter-training corpora
• SSH keys, WireGuard keys, API keys, signing keys, or worker secrets
• upstream model weights unless redistribution is explicitly allowed and the pack has a signed manifest plus checksum evidence
• raw private MLF dumps that bypass the pack builder and source-registry gate
• generated local paths, hostnames, vault paths, or internal staging reports

Catalog State

• Repo id: Lokai-Sovereign/lokai-mlf-catalog
• Catalog models listed locally: 17
• Models optional: true
• GitHub/public stack bundles weights: false
• Product runtime required to use weights: true
• Planned external channels: huggingface, torrent

User Flow

1. Install the Lokai Sovereign Public Stack from the public GitHub release.
2. Open first-run setup.
3. Select an optional model pack recommended for the device and hardware lane.
4. Accept the upstream license/terms.
5. Lokai downloads or imports the pack from this repo, a configured mirror, or a local file chosen by the user.
6. Lokai extracts the pack under public_runtime/.
7. Lokai validates config, tokenizer/tensor map, shard index, MLF shards, per-file checksums, archive checksum, source registry state, and license gate.
8. The model becomes selectable only after validation passes.

Maintainer Publish Flow

1. Rebuild the public trusted model catalog.
2. Rebuild the public model source registry.
3. Validate the public runtime in source-release mode.
4. Build a pack with the guarded pack builder. This strips private paths and writes explicit runtime requirement metadata.
5. Upload the pack zip and pack manifest with the guarded HF uploader.
6. Register the source row from the pack manifest.
7. Re-run the source registry with --require-available before enabling install.

Do not mark a source row install_enabled: true unless the artifact has repo path, size, SHA-256, pack manifest path, pack manifest SHA-256, license evidence, and a public-runtime target path.

Maintainer Rule

Do not upload model payload files by hand. Use the guarded Lokai publish helper so the repo file list, license gate, checksum manifest, and public/private boundary are checked before any remote write. If the GitHub public stack location changes, update LOKAI_PUBLIC_STACK_GITHUB_URL before rendering this README.