Component

core/ai-model/openai-compatible

A broker speaking the OpenAI API, reached as an external reference: no compute runs in-cluster, and what answers behind the endpoint is whatever a Release points it at — a proxy running in the cluster, a gateway, or any service serving that API. It is the component to reach for when an application should not name a provider at all: the endpoint is operator-supplied in the Release and the model is an alias the broker resolves, so which provider actually answers can change with neither the Aggregate nor the application changing. The provider name it carries records which broker sits behind it, for a reader and for a selector to match on rather than for the compiler, which pipes the strings and reads neither. Consumers read the endpoint and the model name over a `uses` edge, the contract every model here publishes. It holds no credential: a consumer that must present a key to the service behind the endpoint declares that key as `credential` on the socket that reaches the endpoint and presents it itself.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:8167b95eca74987e97e5bcdc773acaad4b4734c8cec647405c1f43b483693362
Published
2026-11-10T10:09:30Z
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:8b330ea11d5ca98d3bd61dde2046bfa81b4cddaa0b708770a68a2a980e7e0ed2

Reference at this version

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

Developer parameters

Values the developer sets in the Aggregate.

Extends BaseComponents#/schemas/BaseModelParameter

NameTypeDefaultRequiredDescription
provider_namestring—yes—

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
endpointstring—no—

Output contract

Values this component publishes to consumers over the uses topology.

NameTypeDefaultRequiredDescription
endpointstring—yesBase URL a consumer sends requests to. What answers behind it is whatever the Release points at, so an application reads this instead of naming a provider.
modelstring—yesName a request asks the broker for. It is an alias the broker resolves, so which provider serves it can change without the consumer changing.
providerstring—yesName of the broker answering behind the endpoint. A consumer reads it to record or label which service its requests reached, since the endpoint alone does not say.

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