Ecosystem
NeMo Relay is the agent execution runtime layer in the NVIDIA NeMo ecosystem. It does not replace an agent framework, model provider, guardrail authoring system, or deployment platform. Instead, it gives those systems one shared way to model execution scopes, lifecycle events, middleware, plugins, adaptive behavior, and observability around tool and LLM calls.
Use this page to understand where NeMo Relay fits:
- Inside the NVIDIA NeMo software stack
- Inside agent frameworks, harnesses, and provider adapters
- Across the Rust, Python, Node.js, Go, and C FFI bindings in this repository
How NeMo Relay Fits in the NVIDIA NeMo Ecosystem
The NVIDIA NeMo ecosystem spans model development, agent construction, guardrailing, inference, optimization, and runtime operations. NeMo Relay has a narrower responsibility: it tracks and controls work across scopes, tools, and models.
In practical terms, NeMo Relay answers a different question than higher-level agent products. A framework asks, “What should the agent do next?” NeMo Relay asks, “When the agent does work, which scope owns it, which middleware applies, what events are emitted, and which subscribers can consume the result?”
How NeMo Relay Relates to Other Tooling
NeMo Relay runs alongside application code while the agent is executing. It captures scope, tool, and LLM activity and can apply middleware before or around that work. Telemetry conventions and observability or evaluation products serve different roles and can be used alongside Relay.
Relay is not a replacement for a telemetry standard or an observability backend. Its role is to make the real execution path observable and controllable before the resulting lifecycle data is stored, visualized, or evaluated elsewhere.
The following diagram shows how Relay connects application execution to observability and evaluation systems.
The dotted path shows that an application can call Relay directly without adopting a higher-level framework. In the observability flow, Relay projects events into traces and sends them through an OTLP collector. In the trajectory flow, Relay writes ATIF artifacts for replay or evaluation.
How NeMo Relay Fits Agent Frameworks and Harnesses
The agent framework and harness landscape is intentionally mixed. A team might use NeMo Agent Toolkit, LangChain, LangGraph, an internal orchestration layer, a provider SDK, or direct application code. NeMo Relay is designed to meet those systems at tool, model, and lifecycle hooks, so they do not need to use one common API.
The framework or harness continues to manage:
- Agent orchestration, planning, memory, retries, and scheduling.
- Tool discovery, schemas, and application-visible results.
- Provider clients, authentication, transport, and provider-native objects.
- Public callback signatures and framework-specific behavior.
Relay can receive:
- The scope and parent for work that should be observed.
- A tool or LLM function when Relay can invoke it through managed execution.
- Start and end lifecycle notifications when the framework invokes the function.
- JSON-compatible observability payloads and metadata for events and middleware.
Prefer a managed execution wrapper when a framework lets NeMo Relay invoke the tool or LLM function. Use explicit lifecycle calls or standalone helpers when the framework invokes the function but exposes reliable start, finish, or request transformation hooks.
This arrangement lets subscribers see a consistent scope, tool, and LLM event stream without changing the framework’s public behavior.
Refer to Integrate into Frameworks to choose an integration method. Use Adding Framework Scopes for lifecycle hooks, or Wrapping Tool Calls and Wrapping LLM Calls when Relay can invoke the function.