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.2.0a20260730
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nemo_fabric_adapters_common-0.2.0a20260730.tar.gz | 5.5 kB | Details |
Release files / nemo_fabric_adapters_common-0.2.0a20260730.tar.gz
| Download URL | nemo_fabric_adapters_common-0.2.0a20260730.tar.gz |
|---|---|
| Size | 5.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
87b5753ed83ff61d3044631fd115f4f0e33d03783cf3ec2194a4ac1b91960e2c
|
|
BLAKE2b-256 checksum How to use checksums |
c1b5ff35dfe708293c23623c7147136f5658172ea0b51eba2e4cbb938ea81c34
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.6
|
