nemo-fabric-integrate

Integrate NVIDIA NeMo Fabric into consumer applications through the typed Python SDK.

3.2k|370|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/NVIDIA/skills --skill nemo-fabric-integrate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nemo-fabric-integrate
Source: https://github.com/NVIDIA/skills/tree/main/skills/nemo-fabric-integrate
Command: npx skills add https://github.com/NVIDIA/skills --skill nemo-fabric-integrate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires nemo-fabric, and includes references (resource) components.

What problem does it solve?

Integrating agent harnesses like Claude, Codex, Deep Agents, or Hermes Agent into an existing application, service, or evaluation platform requires translating your own configuration into NeMo Fabric's typed models, choosing the right runtime lifecycle, and handling normalized results correctly. This Skill guides that integration so you avoid unsupported patterns like importing internal modules or reimplementing harness control.

Core Features & Use Cases

  • Config Translation: Map your application, job, or deployment config into an in-memory FabricConfig using public models like HarnessConfig, ModelConfig, and ToolsConfig, with variants created via model_copy(deep=True).
  • Lifecycle Selection: Choose between single-invocation run(...), stateful multi-turn runtimes via start_runtime(...) with async with, native OpenAI streaming, or NeMo Relay ATOF streaming.
  • Validation and Error Handling: Validate adapter selection and environment with plan(...) and doctor(...) before execution, and consume normalized RunResult status, artifacts, telemetry, and FabricError subclasses.
  • Use Case: A platform team adds NeMo Fabric to their evaluation runner so it can invoke Codex or Hermes Agent repeatedly with request correlation, artifact collection, and credential handling through environment variables.

Quick Start

Use the nemo-fabric-integrate skill to add NeMo Fabric to my Python service so it can run agent harness invocations through the typed SDK with validated configuration and normalized results.

Frequently Asked Questions about nemo-fabric-integrate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate NeMo Fabric into a Python application?

Translate your application's configuration object into an in-memory FabricConfig using public models like HarnessConfig, ModelConfig, and RuntimeConfig, then call Fabric().run(...) for single invocations or start_runtime(...) for multi-turn use. Validate with plan(...) and doctor(...) before executing.

How do I choose between run() and start_runtime() in NeMo Fabric?

Use run(...) for a single invocation with no retained state; it handles the full start, invoke, and stop cycle. Use start_runtime(...) as an async context manager when you need ordered multi-turn invocations over one harness lifecycle.

Which Python versions does NeMo Fabric support?

NeMo Fabric supports Python 3.11 through 3.14. Hermes Agent works with Python 3.11 through 3.13, while the Harbor integration requires Python 3.12 or later.

Does NeMo Fabric support streaming responses?

Yes, through two independent paths: native OpenAI Chat Completions chunks via invoke_openai_stream when the adapter declares streaming capability, and raw NeMo Relay ATOF records via invoke_stream with streaming=True. Both require awaiting stream.result() for the terminal RunResult.

How should I handle credentials when using the NeMo Fabric SDK?

Provide model credentials through environment variables named by ModelConfig.api_key_env, never as literals in code. The consumer or execution environment owns installation and credential provisioning; NeMo Fabric never installs harnesses or credentials at run time.

Why does NeMo Fabric raise FabricRuntimeError on shutdown?

Shutdown is attempted but not guaranteed, so stop(), including the automatic call at async with exit, can raise FabricRuntimeError. On normal exit the error propagates; after an invocation failure it is attached to the original exception.