Recipe

nemo-guardrails

The NeMo Guardrails server as a guard in a model's path, for local development via Docker Compose: one service running the image in infra.image, synthesized from the Workload kind by the compose provider. Two compose configs carry the guard's configuration as the product's own two files — config.yaml, naming the Hugging Face classifier rail pointed at the detector wired on the detector socket, with values.threshold and values.blocked_labels; and rails.co, the flow that keeps a request body from switching that rail off. The guard starts in the product's single-configuration mode and refuses a request naming any other configuration. It writes no NemoGuard rail, and halts while the content_safety or jailbreak_detection socket holds a connection. Compose has no env-from-secret primitive, so an attached upstream_key credential is rendered as a plain environment variable, under the name config.yaml gives it, which is therefore also the key the attached credential must publish under; unattached, the guard presents none. The upstream address reaches the guard as MAIN_MODEL_BASE_URL, from infra.upstream_endpoint. The service publishes no port on the host: callers sit on the same compose network. provides.host is the compose service name, and the published contract is key for key the one the Kubernetes realization publishes.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:2363d9fa990f2b40b8f0ddd43f73948f9ee487a1487ba8e72ffc4cdab5ca8a5c
Published
2026-11-10T10:19:58Z
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:4ae91edc1440362b96f770c93906b4d8f2769686010d7602db4beea803ee2f86

Reference at this version

oci://hub.aggrega.ai/recipe/compose/nemo-guardrails:1.0.0
Target
—
Implements
core/security/nemo-guardrails:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.instance_id }}
port{{ .infra.port }}
endpointhttp://{{ .context.instance_id }}:{{ .infra.port }}/v1
protocolhttp
threshold{{ .values.threshold }}

Workload

Workload · form: stateless · containers: main

Locals

NameTemplate
config_name{{ .context.instance_id }}-config
flow_config_name{{ .context.instance_id }}-flow
config_idconfig
config_dir/app/config/config
upstream_key_variableUPSTREAM_API_KEY
classifier_nameprompt_injection

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/security/nemo-guardrails: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.

Recipe 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