Struct LLMResource 

pub struct LLMResource {

    pub id: String,
    pub name: String,
    pub provider: Option<String>,
    pub format: String,
    pub quantization: Option<String>,
    pub size_mb: Option<u32>,
    pub download: DownloadInfo,
    pub license: Option<String>,
    pub recommended_for: Option<Vec<String>>,
    pub ram_estimate_mb: Option<u32>,
    pub tags: Option<Vec<String>>,
    pub last_verified: Option<String>,
    pub notes: Option<String>,
    pub modality: Option<String>,
    pub vision_projector: Option<DownloadInfo>,
    pub architecture: Option<String>,
    pub context_window: Option<u32>,
}

A downloadable LLM / model package (primarily GGUF).

Fields

id: String

name: String

provider: Option<String>

format: String

File format — always "gguf" for Qualia-compatible models.

quantization: Option<String>

Quantization level (e.g. "Q4_K_M", "Q8_0").

size_mb: Option<u32>

Compressed file size in MB.

download: DownloadInfo

license: Option<String>

recommended_for: Option<Vec<String>>

ram_estimate_mb: Option<u32>

Peak RAM required (model + runtime overhead) in MB.

tags: Option<Vec<String>>

last_verified: Option<String>

notes: Option<String>

modality: Option<String>

text (default) or multimodal (requires vision_projector).

vision_projector: Option<DownloadInfo>

Vision / CLIP projector GGUF paired with the language model.

architecture: Option<String>

Architecture family for multimodal routing: llava, qwen2vl, smolvlm, gemma3.

context_window: Option<u32>

Recommended decode context window in tokens.

Implementations

impl LLMResource

pub fn is_multimodal(&self) -> bool

pub fn effective_context_window(&self) -> u32

pub fn to_quins(&self) -> Vec<NQuin>

Encode this catalog entry as a set of NQuins.

Returns Quins using the catalog:llm context graph. Vec allocation is intentional — this runs once at catalog load, not in a hot evaluator loop.

pub fn provenance_quin(&self, timestamp_unix: u64, local_path: &str) -> NQuin

Generate a provenance NQuin recording a completed download event.

Written to the WAL immediately after the file is saved to disk.

pub fn source_url_quin(&self) -> Option<NQuin>

Generate a supplementary provenance Quin recording the source URL.

pub fn to_capability_profile(&self, local_path: &str) -> CapabilityProfile

Build a CapabilityProfile for this model, bound to its local file path.

The profile ID is deterministic: q_hash("profile:{id}"), so callers can look it up without storing a separate reference.

pub fn to_capability_profile_with_projector( &self, local_path: &str, vision_projector_path: Option<&str>, ) -> CapabilityProfile

Trait Implementations

impl Clone for LLMResource

fn clone(&self) -> LLMResource

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LLMResource

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LLMResource

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LLMResource

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.