Component

core/ai-model/huggingface

Hugging Face's managed Inference API, reached as an external reference: no compute runs in-cluster and the compiler never calls the provider. It fronts models of several kinds rather than one, so beside the model name the component exposes the task a request is for — generating text, transforming it, or returning features — which is what decides the shape of the answer. Its host is fixed, so the realization publishes the endpoint itself and a Release supplies none. The API key is the consumer's to attach: the environment-variable name it arrives under belongs to the application rather than to the model.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:6390e0adda266cc324633dc5d6423982c1f3346d76a81e6f76e40aff7b544215
Published
2026-11-10T10:09:15Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:67708bfd7f7f6cc09c724f2d0c11cc38e411fab25abe9d0163e0126eb2689038

Reference at this version

oci://hub.aggrega.ai/component/core/ai-model/huggingface:1.0.0

Developer parameters

Values the developer sets in the Aggregate.

Extends BaseComponents#/schemas/BaseModelParameter

NameTypeDefaultRequiredDescription
taskstring (text-generation | text2text-generation | feature-extraction)text-generationyes—

Operator sizing

Infrastructure sizing the operator tunes per environment.

No operator sizing declared.

Output contract

Values this component publishes to consumers over the uses topology.

NameTypeDefaultRequiredDescription
endpointstring—yesBase URL of the Hugging Face Inference API. The host is fixed, so the realization publishes it and a consumer points its client here without a Release supplying anything.
modelstring—yesRepository id of the model a request is sent to. The API routes on it, so a consumer appends it to the endpoint or passes it as the model field.

Uses sockets

The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.

No uses sockets declared.

Attachment slots

Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.

No attachment slots declared.

Self-inject allowlist

No self-inject pipes declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

Used by

Component concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy