Skip to main content

HCS-25 (Signal): Hugging Face Model Index (Informative)

PurposeDirect link to Purpose

Collect model metadata and evaluation-like indicators from Hugging Face, including a normalized score derived from:

  • model-index metrics (when present), and/or
  • popularity proxies (downloads/likes).

Stored fields (example schema)Direct link to Stored fields (example schema)

Stored in subject.metadata.additional:

FieldTypeMeaning
huggingFaceModelIdstring | nullCanonical HF model id
openrouterHuggingFaceIdstring | nullHF id resolved via OpenRouter
huggingFaceEvalScorenumber | nullNormalized score [0,100]
huggingFaceSignalScorenumber | nullOptional alias of huggingFaceEvalScore used by some ingest pipelines
huggingFaceEvalMetricsCountnumberIncluded metrics count
huggingFaceDownloadsnumber | nullPopularity proxy
huggingFaceLikesnumber | nullPopularity proxy
huggingFaceEvalModemodel-index | popularity | mixed | missingScore mode
huggingFaceEvalStatusok | missing | errorStatus
huggingFaceEvalUpdatedAtISO timestampRefresh time
huggingFaceEvalSourcesstring[]Source identifiers

Production example (Registry Broker; informative)Direct link to Production example (Registry Broker; informative)

  • Endpoint: https://hol.org/registry/api/v1/agents/{uaid}
  • Example UAID: uaid:aid:82BHmpsiwqfeUTsazhWGkxj8UaV1q7qwVcXBZMS7PfDGkibnteEajdgCsd5qQYAm4f