Struct ModelCard 

pub struct ModelCard {
    pub name: String,
    pub backend: Option<Backend>,
    pub footprint_gib: Option<f64>,
    pub gated: Option<bool>,
    pub family: Option<String>,
    pub vllm: Option<VllmProfile>,
    pub ollama: Option<OllamaProfile>,
    pub tuning: Option<Tuning>,
    pub capability: Option<Capability>,
}

A model card: everything needed to stand up one model. name is required (it is the merge key); every other field is Option so a partial overlay overrides only what it sets.

Fields

name: String

Model identity, e.g. Ornith-1.0-35B. The merge / drop-in key.

backend: Option<Backend>

Which backend setup stands up.

footprint_gib: Option<f64>

Approximate resident footprint (GiB) — a serving knob (like ModelVariant.gib), not a machine id; used by the hardware-fit gate.

gated: Option<bool>

Likely exceeds a typical node (e.g. the 397B) — setup warns / requires --force.

family: Option<String>

The model family this card belongs to (e.g. "qwen3"), if any — looks up family_defaults as the base layer UNDER this card’s own [vllm] table in resolve, so cards in the same family (different sizes of the same tokenizer/parser lineage) don’t each duplicate reasoning_parser/tool_call_parser/etc. None means no family layer applies — today’s pre-family behavior, unchanged.

vllm: Option<VllmProfile>

ollama: Option<OllamaProfile>

tuning: Option<Tuning>

capability: Option<Capability>

Implementations

impl ModelCard

pub fn merge(self, overlay: Self) -> Self

Overlay self under overlay — overlay wins field-by-field, deep-merging the nested tables. Pure. Precedence chains left-to-right: builtin.merge(dropin).merge(one_off).merge(flags).

pub fn validate(&self) -> Result<(), String>

Reject a structurally-invalid card loudly (never silently): empty name, no backend, a backend whose serving block is absent, or a family naming no known family defaults (almost always a typo — silently applying no defaults would be a quieter, harder-to-notice version of the same mistake deny_unknown_fields guards against elsewhere in this module).

Errors

Returns a human-readable reason when the card cannot be stood up.

pub fn to_toml(&self) -> Result<String, String>

The card as canonical TOML (for card show / seeding ~/.newt).

Errors

Propagates a serialization error (should not occur for a valid card).

Trait Implementations

impl Clone for ModelCard

fn clone(&self) -> ModelCard

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelCard

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

Formats the value using the given formatter.

impl Default for ModelCard

fn default() -> ModelCard

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ModelCard

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ModelCard

fn eq(&self, other: &ModelCard) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ModelCard

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ModelCard