Skip to content
Merged
Show file tree
Hide file tree
Changes from 13 commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
aea180f
fix(onboard): restore N1x standard onboarding
sandl99 Sep 4, 2026
393f741
fix(onboard): harden N1x standard admission
sandl99 Sep 4, 2026
cb8844e
fix(onboard): close N1x review gaps
sandl99 Sep 4, 2026
f0b6497
fix(rebuild): preserve N1x standard provider intent
sandl99 Sep 4, 2026
5ee613c
Merge branch 'main' into fix/n1x-non-express-onboarding-11041
sandl99 Sep 4, 2026
b074586
fix(onboard): limit N1x fallback to accepted scope
sandl99 Sep 4, 2026
0391b03
fix(onboard): simplify N1x standard fallback
sandl99 Sep 4, 2026
17ace52
Merge branch 'main' into fix/n1x-non-express-onboarding-11041
sandl99 Sep 4, 2026
aa25dda
Merge branch 'main' into fix/n1x-non-express-onboarding-11041
sandl99 Sep 4, 2026
aee4a24
merge: integrate main into N1x onboarding fix
ericksoa Sep 4, 2026
a840302
fix(onboard): close N1x standard fallback review gaps
ericksoa Sep 4, 2026
fa5ac84
fix(onboard): preserve validated N1x provider intent
ericksoa Sep 4, 2026
ea14fe3
test(installer): prove N1x decline reaches onboarding
ericksoa Sep 4, 2026
1519c57
fix(rebuild): preserve standard N1x provider intent
ericksoa Sep 4, 2026
30db99c
refactor(onboard): unify persisted provider mapping
ericksoa Sep 4, 2026
b9c1f1f
refactor(onboard): centralize provider definitions
ericksoa Sep 4, 2026
e253c20
fix(ci): read shared provider definitions
ericksoa Sep 4, 2026
96ae71e
refactor(onboard): preserve provider identity owners
ericksoa Sep 4, 2026
8fa6ac1
merge: integrate current main before N1x approval
ericksoa Sep 4, 2026
525ce43
fix(onboard): finish N1x ownership and guidance
ericksoa Sep 4, 2026
1263985
fix(onboard): preserve providerless N1x resume intent
ericksoa Sep 4, 2026
732b2bb
Merge remote-tracking branch 'origin/main' into codex/pr11046-remediate
ericksoa Sep 4, 2026
9423023
test(onboard): prove the N1x decline transition
ericksoa Sep 4, 2026
93fd953
test(ci): own installer provider parity
ericksoa Sep 4, 2026
60226d0
docs(onboard): distinguish N1x preview intent
ericksoa Sep 4, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions ci/platform-matrix.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"$comment": "SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\nSPDX-License-Identifier: Apache-2.0\n\nSingle source of truth for NemoClaw launch claims and platform support. Covers platforms, inference providers, supported agents, messaging integrations, and deployment paths. Scripts read this to generate README and docs tables. QA/CI update platform/provider rows; the engineering owner reviews other rows. Docs are derived.",
"version": "1.1",
"updated": "2026-08-14",
"updated": "2026-09-04",

"project_status": {
"stage": "alpha",
Expand Down Expand Up @@ -74,7 +74,7 @@
"status": "deferred",
"ci_tested": false,
"prerequisites_notes": "N1x Express remains Deferred until a physical NemoClaw Express E2E test passes. Host identity requires Linux `arm64`, a trusted `/etc/fastos-release` marker with `NAME=\"N1x FASTOS\"`, and NVIDIA vendor ID `10de` on a display-class PCI device. CUDA and Container Device Interface (CDI) readiness are still required.",
"notes": "The accepted Deferred N1x Express preview selects one-host managed vLLM with `nvidia/Qwen3.6-35B-A3B-NVFP4`. It does not activate DGX Spark cluster discovery, the fixed catalog path, managed llama.cpp, or NVIDIA NIM. Host identity requires Linux `arm64`, a regular `/etc/fastos-release` file of 1 through 4,096 bytes that is owned by UID 0 and GID 0, is not a symbolic link, is not group- or world-writable, and contains exactly one `NAME=\"N1x FASTOS\"` line. It also requires NVIDIA vendor ID `10de` on a display-class PCI device. Generic DMI values are supplemental and FastOS version is not pinned. Physical CUDA and CDI checks passed on one N1x host, but full NemoClaw Express E2E validation and dedicated CI coverage are pending. `host.platform.supported` remains absent; only explicit managed-vLLM preview intent can waive the pending-validation finding. Do not claim N1x as supported until that validation passes and this row is promoted."
"notes": "The accepted Deferred N1x Express preview selects one-host managed vLLM with `nvidia/Qwen3.6-35B-A3B-NVFP4`. It does not activate DGX Spark cluster discovery, the fixed catalog path, managed llama.cpp, or NVIDIA NIM. Host identity requires Linux `arm64`, a regular `/etc/fastos-release` file of 1 through 4,096 bytes that is owned by UID 0 and GID 0, is not a symbolic link, is not group- or world-writable, and contains exactly one `NAME=\"N1x FASTOS\"` line. It also requires NVIDIA vendor ID `10de` on a display-class PCI device. Generic DMI values are supplemental and FastOS version is not pinned. Physical CUDA and CDI checks passed on one N1x host, but full NemoClaw Express E2E validation and dedicated CI coverage are pending. `host.platform.supported` remains absent. After identity qualifies, accepting Express can waive only the pending-validation finding. Declining or disabling Express can apply the same waiver when no provider is preselected or the explicit provider is recognized and is not Local NVIDIA NIM. An invalid or Local NVIDIA NIM provider remains blocked. Existing provider requirements still apply, and this waiver does not promote N1x. Do not claim N1x as supported until validation passes and this row is promoted."
},
{
"name": "NVIDIA RTX (consumer and Pro workstation GPUs)",
Expand Down Expand Up @@ -157,13 +157,13 @@
"name": "Local NVIDIA NIM",
"status": "experimental",
"endpoint_type": "Local OpenAI-compatible",
"notes": "Requires `NEMOCLAW_EXPERIMENTAL=1` and a NIM-capable NVIDIA GPU. Host must have the NVIDIA Container Toolkit installed and a healthy CDI spec. Onboarding evaluates the canonical `host.gpu.nvidia_available`, `host.gpu.container_toolkit_available`, and `host.gpu.cdi_healthy` readiness capabilities before gateway, image, or sandbox lifecycle effects. NIM images pull from `nvcr.io` and require NGC registry login. NemoClaw gates this path behind the experimental flag. Onboarding filters the validated image list by usable memory. In non-interactive mode, onboarding selects the first compatible model unless the operator sets `NEMOCLAW_MODEL`. Model selection uses detected free GPU memory. If free memory is unavailable, NemoClaw uses total GPU memory. On DGX Spark, NemoClaw caps usable memory at 50 percent of total memory to match NIM's reported unified-memory limit. The Nemotron 3 Super catalog minimum includes NIM's reported runtime allocation. Local NVIDIA NIM is unavailable on N1x. NemoClaw omits the provider from onboarding and rejects `NEMOCLAW_PROVIDER=nim-local` on N1x. Use the Deferred managed-vLLM preview on N1x. On Linux arm64 DGX Spark and DGX Station hosts, onboarding warns that some NIM images may not publish a `linux/arm64` manifest; the warning is advisory, and the selected image pull can still fail when the registry has no matching platform manifest. Managed vLLM has host-specific default models and is not gated on the same boxes. Validated images referenced in `src/lib/inference/config.ts` and `nemoclaw/src/index.ts`: `nvidia/nemotron-3-super-120b-a12b` (default cloud model), `nvidia/nemotron-3-nano-30b-a3b`, `nvidia/llama-3.3-nemotron-super-49b-v1.5`."
"notes": "Requires `NEMOCLAW_EXPERIMENTAL=1` and a NIM-capable NVIDIA GPU. Host must have the NVIDIA Container Toolkit installed and a healthy CDI spec. Onboarding evaluates the canonical `host.gpu.nvidia_available`, `host.gpu.container_toolkit_available`, and `host.gpu.cdi_healthy` readiness capabilities before gateway, image, or sandbox lifecycle effects. NIM images pull from `nvcr.io` and require NGC registry login. NemoClaw gates this path behind the experimental flag. Onboarding filters the validated image list by usable memory. In non-interactive mode, onboarding selects the first compatible model unless the operator sets `NEMOCLAW_MODEL`. Model selection uses detected free GPU memory. If free memory is unavailable, NemoClaw uses total GPU memory. On DGX Spark, NemoClaw caps usable memory at 50 percent of total memory to match NIM's reported unified-memory limit. The Nemotron 3 Super catalog minimum includes NIM's reported runtime allocation. Local NVIDIA NIM is unavailable on N1x. NemoClaw omits the provider from onboarding and rejects `NEMOCLAW_PROVIDER=nim-local` on N1x. Select another standard provider or use the Deferred managed-vLLM preview on N1x. On Linux arm64 DGX Spark and DGX Station hosts, onboarding warns that some NIM images may not publish a `linux/arm64` manifest; the warning is advisory, and the selected image pull can still fail when the registry has no matching platform manifest. Managed vLLM has host-specific default models and is not gated on the same boxes. Validated images referenced in `src/lib/inference/config.ts` and `nemoclaw/src/index.ts`: `nvidia/nemotron-3-super-120b-a12b` (default cloud model), `nvidia/nemotron-3-nano-30b-a3b`, `nvidia/llama-3.3-nemotron-super-49b-v1.5`."
},
{
"name": "Local vLLM (already running)",
"status": "caveated",
"endpoint_type": "Local OpenAI-compatible",
"notes": "Unavailable on N1x. On other hosts, it appears in the onboarding menu when NemoClaw detects a server on `localhost:${NEMOCLAW_VLLM_PORT:-8000}`. No flag is required. The model is whatever the existing server serves."
"notes": "On a qualified N1x host, this route requires explicit standard-onboarding intent and remains unvalidated. On other hosts, no explicit intent is required. It appears in the onboarding menu when NemoClaw detects a server on `localhost:${NEMOCLAW_VLLM_PORT:-8000}`. The model is whatever the existing server serves."
},
{
"name": "Local vLLM (managed install/start)",
Expand Down
12 changes: 6 additions & 6 deletions docs/get-started/quickstart-hermes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -61,14 +61,14 @@ Review the [Prerequisites](prerequisites) before you begin.
Press Enter to use the recommended express install mode for that platform.
This mode applies preset settings and runs the remaining onboarding non-interactively.
Express install mode preserves the explicit Hermes selection in the install command.
On supported non-N1x express platforms, enter `n` if you want to select a sandbox name, an inference provider, and a model interactively.
On N1x, entering `n` stops installation because the Deferred managed-vLLM preview is the only admitted onboarding path.
Enter `n` if you want to select a sandbox name, an inference provider, and a model interactively.
On N1x, the selected provider must meet its existing requirements, and local NVIDIA NIM remains unavailable.
Refer to [Use a container runtime and supported platforms](#use-a-container-runtime-and-supported-platforms) for more information.
</Note>

The install command creates the `my-hermes` sandbox used in the commands that follow.
If you accept Express setup, wait for the installer to finish, then continue with **Confirm the Sandbox Is Ready**; Express selects the provider and model non-interactively.
If the installer does not offer Express setup, or if you enter `n` at the Express prompt on a supported non-N1x host, choose an inference provider and model, then provide its credential when prompted.
If the installer does not offer Express setup, or if you enter `n` at the Express prompt, choose an inference provider and model, then provide its credential when prompted.
For that interactive path, skip optional web search and messaging setup on a first run, then accept the suggested network policy tier.
With the OpenShell Docker driver, stock Hermes onboarding normally uses the release's exact managed-image digest.
If registry or catalog availability prevents resolution, stock onboarding stops before sandbox creation and does not build a shipped Dockerfile.
Expand Down Expand Up @@ -267,9 +267,9 @@ Use these details when your first-run path needs more control.
N1x remains outside the supported-platform set until that validation passes and the platform matrix status is promoted.
Press Enter at the express install prompt to apply preset settings, switch the remaining onboarding to non-interactive mode, and select the managed local inference path for that platform.
On N1x, accept the preview prompt to apply those settings as explicit Deferred preview intent.
On supported non-N1x express platforms, enter `n` to continue with interactive onboarding when you want to select the agent or other settings yourself.
On N1x, declining the preview or setting only `NEMOCLAW_NO_EXPRESS=1` stops installation before onboarding.
Accept the preview, or set `NEMOCLAW_PROVIDER=install-vllm` before installation to provide the required explicit managed-vLLM intent.
Enter `n` to continue with interactive onboarding when you want to select the agent or other settings yourself.
On N1x, setting `NEMOCLAW_NO_EXPRESS=1` also continues with ordinary onboarding.
Set `NEMOCLAW_PROVIDER=install-vllm` to bypass the prompt with managed-vLLM preview intent, or set another provider to enter standard onboarding directly.
The first Hermes start can take several minutes while OpenShell pulls the managed image when it is not already cached.
The N1x preview selects one-host managed vLLM with `nvidia/Qwen3.6-35B-A3B-NVFP4`.
Refer to [Set Up vLLM](../inference/local-inference/set-up-vllm) for managed model profiles and headless setup.
Expand Down
12 changes: 6 additions & 6 deletions docs/get-started/quickstart-langchain-deepagents-code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -57,14 +57,14 @@ If you use the coding-agent prompt in the preceding section, you can skip this p
Press Enter to use the recommended express install mode for that platform.
This mode applies preset settings and runs the remaining onboarding non-interactively.
Express install mode preserves the explicit Deep Agents selection in the install command.
On supported non-N1x express platforms, enter `n` if you want to select a sandbox name, an inference provider, and a model interactively.
On N1x, entering `n` stops installation because the Deferred managed-vLLM preview is the only admitted onboarding path.
Enter `n` if you want to select a sandbox name, an inference provider, and a model interactively.
On N1x, the selected provider must meet its existing requirements, and local NVIDIA NIM remains unavailable.
Refer to [Use a container runtime and supported platforms](#use-a-container-runtime-and-supported-platforms) for more information.
</Note>

The install command creates the `my-deepagents` sandbox used in the commands that follow.
If you accept Express setup, wait for the installer to finish, then continue with **Confirm the Sandbox Is Ready**; Express selects the provider and model non-interactively.
If the installer does not offer Express setup, or if you enter `n` at the Express prompt on a supported non-N1x host, choose an inference provider and model, then provide its credential when prompted.
If the installer does not offer Express setup, or if you enter `n` at the Express prompt, choose an inference provider and model, then provide its credential when prompted.
For that interactive path, accept the suggested network policy tier on a first run.
With the OpenShell Docker driver, stock Deep Agents Code onboarding normally uses the release's exact managed-image digest.
If registry or catalog availability prevents resolution, stock onboarding stops before sandbox creation and does not build a shipped Dockerfile.
Expand Down Expand Up @@ -127,9 +127,9 @@ Use these details when you need more control during setup or after the first san
N1x remains outside the supported-platform set until that validation passes and the platform matrix status is promoted.
Press Enter at the express install prompt to apply preset settings, switch the remaining onboarding to non-interactive mode, and select the managed local inference path for that platform.
On N1x, accept the preview prompt to apply those settings as explicit Deferred preview intent.
On supported non-N1x express platforms, enter `n` to continue with interactive onboarding when you want to select the agent or other settings yourself.
On N1x, declining the preview or setting only `NEMOCLAW_NO_EXPRESS=1` stops installation before onboarding.
Accept the preview, or set `NEMOCLAW_PROVIDER=install-vllm` before installation to provide the required explicit managed-vLLM intent.
Enter `n` to continue with interactive onboarding when you want to select the agent or other settings yourself.
On N1x, setting `NEMOCLAW_NO_EXPRESS=1` also continues with ordinary onboarding.
Set `NEMOCLAW_PROVIDER=install-vllm` to bypass the prompt with managed-vLLM preview intent, or set another provider to enter standard onboarding directly.

The N1x preview selects one-host managed vLLM with `nvidia/Qwen3.6-35B-A3B-NVFP4`.

Expand Down
14 changes: 7 additions & 7 deletions docs/get-started/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -61,9 +61,9 @@ Review the [Prerequisites](prerequisites) before you begin.
Press Enter to use the recommended preset settings on a qualified platform or to explicitly opt into the Deferred N1x preview.
Express install mode completes the remaining onboarding non-interactively.
If you accept, wait for the installer to finish, then continue with **Confirm the Sandbox Is Ready**.
On N1x, entering `n` stops installation because the Deferred managed-vLLM preview is the only admitted onboarding path.
Re-run and accept the preview, or set `NEMOCLAW_PROVIDER=install-vllm` before installation.
On the other express platforms, enter `n` to continue with the interactive onboarding flow described in this step.
On N1x, enter `n` to continue with the interactive onboarding flow described in this step.
N1x remains Deferred, and the provider that you select must meet its existing requirements.
Local NVIDIA NIM remains unavailable on N1x.
</Note>
</Step>

Expand Down Expand Up @@ -197,14 +197,14 @@ Use these details when your first-run path needs more control.
After you press Enter at the express install prompt, or explicitly accept the Deferred N1x preview, the installer switches the remaining onboarding to non-interactive mode and selects the managed local inference path for that platform.
Express install mode uses `my-assistant` unless you set `NEMOCLAW_SANDBOX_NAME`, and it applies the suggested Balanced policy.
It can still prompt for `sudo` when host setup needs it.
On the other express platforms, set `NEMOCLAW_NO_EXPRESS=1` to skip the express prompt, or set `NEMOCLAW_PROVIDER` to choose a provider yourself.
On any express platform, set `NEMOCLAW_NO_EXPRESS=1` to skip the express prompt, or set `NEMOCLAW_PROVIDER` to choose a provider yourself.

N1x Express selects one-host managed vLLM with `nvidia/Qwen3.6-35B-A3B-NVFP4`.
N1x detection requires Linux `arm64`, a trusted `/etc/fastos-release` marker with `NAME="N1x FASTOS"`, and NVIDIA vendor ID `10de` on a display-class PCI device.
The N1x path does not use DGX Spark cluster discovery, the fixed catalog path, managed llama.cpp, or NVIDIA NIM.
Accepting the N1x prompt supplies the narrow preview intent required to pass the pending-validation readiness finding.
Declining the N1x prompt or setting only `NEMOCLAW_NO_EXPRESS=1` stops installation before onboarding; neither path opens interactive provider selection.
Set `NEMOCLAW_PROVIDER=install-vllm` when you need to bypass the N1x preview prompt with the same explicit intent.
Accepting the N1x prompt supplies the narrow managed-vLLM preview intent required to pass the pending-validation readiness finding.
Declining the N1x prompt or setting `NEMOCLAW_NO_EXPRESS=1` continues with ordinary interactive onboarding.
Set `NEMOCLAW_PROVIDER=install-vllm` to bypass the prompt with managed-vLLM preview intent, or set another provider to enter standard onboarding directly.
Refer to [Platform Support](../reference/platform-support) before you rely on this path.

Before the Station express confirmation, the installer reports whether the Hugging Face download is authenticated without displaying the token value.
Expand Down
Loading
Loading