Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

NVIDIA NeMo Fabric Adapter Utilities

nemo-fabric-adapters-common provides shared Python helpers for NeMo NeMo Fabric adapter implementations. Adapter packages normally install this package as a dependency.

Install the package directly when developing an adapter:

pip install nemo-fabric-adapters-common

Refer to the NeMo Fabric documentation for adapter and configuration guidance. Source code is available in the NVIDIA NeMo Fabric repository.

Persistent Local Hosts

Every local Process or Python adapter implements the ordered persistent-host wire protocol. Python adapters can use nemo_fabric_adapters.common.lifecycle. Supply a factory that creates one adapter-owned runtime with asynchronous start, invoke, and stop methods:

from nemo_fabric_adapters.common import lifecycle


class AdapterRuntime:
    async def start(self, payload):
        self.client = await connect_client(payload)

    async def invoke(self, payload):
        return await self.client.run(payload["request"]["input"])

    async def stop(self):
        await self.client.close()


lifecycle.serve(AdapterRuntime)

NeMo Fabric calls the factory once per local host to create one runtime instance and serializes invocations through that instance. The host keeps one event loop alive for the complete lifecycle so SDK clients, compiled graphs, checkpointers, and harness databases can remain live safely. NeMo Fabric sends the resolved configuration and capability plan during start. Each subsequent invoke wire payload contains only runtime_context and request, and the helper passes that payload to AdapterRuntime.invoke unchanged. An adapter that needs configuration during invocation retains it as runtime-owned state during start. Adapter stdout is reserved for the protocol; diagnostics are redirected to stderr. A host crash or protocol timeout terminates that runtime.

Metadata

Release files for nemo-fabric-adapters-common 0.1.0a20260726

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nemo-fabric-adapters-common 0.1.0a20260726
File Size Uploaded
nemo_fabric_adapters_common-0.1.0a20260726.tar.gz 5.8 kB Details

Release files / nemo_fabric_adapters_common-0.1.0a20260726.tar.gz

Download URL nemo_fabric_adapters_common-0.1.0a20260726.tar.gz
Size 5.8 kB
Tags Source
SHA-256 checksum
How to use checksums
abd39524f21d644a7dda6915bb73df2c6d414401b8e5d505898046506604b60a
BLAKE2b-256 checksum
How to use checksums
d3d540f4e87d987a89ba910611cd959d11ffcdb58bb65e2a46ae828e8dc6efd1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Release history Release notifications | RSS feed

0.5.0

1 release file

0.4.0

1 release file

0.3.0

1 release file

0.2.0

1 release file

0.1.1

1 release file

0.1.0

1 release file

This release

0.1.0a20260726 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page