AiModelArtifact ai.model-artifact@1

Generated at from openvibe-contracts v0.419.0 and openvibe-sdk v0.161.0.

Version
1.0.0
Owner
ai
Visibility
first-party
Status
active
Compatibility
backward
Schema
https://openvibe.network/contracts/ai/model-artifact.v1.json

ai.model-artifact@1: one pinned revision/variant/quantization of a model family. Identified by an exact id (`<org>/<model>[:<quant>]@<revision>`), with its weight SHA-256, tokenizer revision, license and provenance.

Fields

FieldTypeRequiredDescriptionConstraints
idstringyesExact artifact id: `<org>/<model>[:<quant>]@<revision>`.
  • pattern ^[a-zA-Z0-9._-]+/[a-zA-Z0-9._-]+(:[a-zA-Z0-9._-]+)?@[a-zA-Z0-9._-]+$
  • maxLength 256
familystringyesUnderlying model family, e.g. `qwen3`.
variantenumyesHow the weights were produced.
  • one of "original", "abliterated", "finetuned", "merged", "lora"
quantstringyesQuantization label, e.g. `q4_k_m` or `fp16`.
revisionstringyesArtifact revision or commit hash.
sha256stringyesSHA-256 of the weight file or signed manifest.
  • pattern ^[a-f0-9]{64}$
tokenizer_revisionstring | nullTokenizer/chat-template revision used with this artifact.
licensestringyesSPDX license identifier or custom license name.
source_urlstringCanonical download or provenance URL.
  • format uri
contextintegerMaximum context length in tokens.
  • minimum 1
created_atstring
  • format date-time

Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

Valid: llama
{
  "id": "meta-llama/llama_3.1_8b_instruct:fp16@bca2580",
  "family": "llama3.1",
  "variant": "original",
  "quant": "fp16",
  "revision": "bca2580",
  "sha256": "00112233445566778899aabbccddeeff00112233445566778899aabbccddeeff",
  "tokenizer_revision": "bca2580",
  "license": "llama3.1",
  "source_url": "https://huggingface.co/meta-llama/Llama-3.1-8B-Instruct",
  "context": 131072,
  "created_at": "2026-11-03T00:00:00.000Z"
}
Valid: qwen
{
  "id": "qwen/qwen3-9b-abliterated:q4_k_m@3f2a1c9",
  "family": "qwen3",
  "variant": "abliterated",
  "quant": "q4_k_m",
  "revision": "3f2a1c9",
  "sha256": "aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899",
  "tokenizer_revision": "3f2a1c9",
  "license": "apache-2.0",
  "source_url": "https://huggingface.co/qwen/qwen3-9b-abliterated-gguf",
  "context": 32768,
  "created_at": "2026-11-03T00:00:00.000Z"
}
Rejected: bad-id
{
  "id": "qwen3-9b@3f2a1c9",
  "family": "qwen3",
  "variant": "original",
  "quant": "q4_k_m",
  "revision": "3f2a1c9",
  "sha256": "aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899",
  "license": "apache-2.0"
}
Rejected: invalid-variant
{
  "id": "qwen/qwen3-9b-abliterated:q4_k_m@3f2a1c9",
  "family": "qwen3",
  "variant": "censored",
  "quant": "q4_k_m",
  "revision": "3f2a1c9",
  "sha256": "aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899",
  "license": "apache-2.0"
}
Rejected: missing-sha256
{
  "id": "qwen/qwen3-9b-abliterated:q4_k_m@3f2a1c9",
  "family": "qwen3",
  "variant": "abliterated",
  "quant": "q4_k_m",
  "revision": "3f2a1c9",
  "license": "apache-2.0"
}

Validate

const contracts = require('openvibe-contracts');
contracts.validate('ai.model-artifact@1', value);   // { valid, errors: [{ path, message }] }