Recipe
nvidia-nim
NVIDIA Inference Microservice as a self-hosted, GPU-native inference server on a single Docker host via Docker Compose, synthesized from the Workload kind. The NIM container resolves the model profile into a named model-cache volume at start and serves the OpenAI-compatible API on the compose network; the compiler never fetches the profile. The image is infra.image, which the Release supplies: the catalog names no NIM image, since NIM images are distributed under NVIDIA's own terms. Docker pulls it with the host's own registry login, so where the image needs credentials, log the host in to nvcr.io first; infra.image_pull_secret names a Kubernetes Secret, and a Release setting it here halts the build. An attached ngc_api_key arrives on the inject pipe and is rendered as the NGC_API_KEY variable, written into the file as delivered: attach a Compose variable reference such as ${NGC_API_KEY} to keep the key out of it. Unattached, no such variable is emitted. The service always reserves infra.gpu.count NVIDIA GPUs, at least one, which the host must hand to containers through the NVIDIA Container Toolkit. The replica count and the GPU runtime class are reported as unsupported-field warnings, and the service declares no healthcheck, because NVIDIA does not document a health client inside the image. provides.host is the compose service name; provides.metrics_endpoint is always set, since compose runs one instance.
Provenance
- Content digest
- sha256:88d4fcd5b645ad6e02fddbacf61693a180ed07c9ee8b444810df1b2b3aaa8f06
- Published
- 2026-11-10T10:20:03Z
- 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:948a87634e4104444fa05f09a5700101c4eefd2948e5306754268012bfcad8a6
Reference at this version
oci://hub.aggrega.ai/recipe/compose/nvidia-nim:1.0.0- Target
- —
- Implements
- core/ai-model/nvidia-nim:1.0.0
Provides
Deterministic pointer templates this recipe wires for consumers.
| Name | Template |
|---|---|
| host | {{ .context.instance_id }} |
| port | {{ .infra.port }} |
| endpoint | http://{{ .context.instance_id }}:{{ .infra.port }}/v1 |
| model | {{ .values.model }} |
| protocol | http |
| metrics_endpoint | http://{{ .context.instance_id }}:{{ .infra.port }}/v1/metrics |
| metrics_service | |
| metrics_service_port | |
| metrics_path |
Workload
Workload · form: stateless · replicas: {{ · containers: main
Locals
No locals declared.
Values mapping
No values mapping 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
- implementsimplementscontract compatible
core/ai-model/nvidia-nim:1.0.0
All required outputs are satisfied and every provided output is named in the contract.
Used by
Nothing in the catalog depends on this entity.