Nemo Relay Migrate From Flow
NVIDIAOfficialCreated by NVIDIA Corporation and Affiliates
- Skill
- Workflow
- Software development
- Apache-2.0
- Medium risk
- Has scripts
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
This skill provides a structured workflow and automation helper for migrating existing NeMo Flow applications, documentation, and configurations to NeMo Relay. It focuses on mechanical renaming across multiple programming languages and surfaces, including Python, Rust, Node.js, Go, C FFI, and CLI configurations, while ensuring safe handling of project-specific settings and dependencies.
What it does
- Identifies and renames NeMo Flow identifiers to NeMo Relay across source code and documentation.
- Provides a dry-run mode to review all proposed file renames and text edits before application.
- Handles language-specific updates for package managers, imports, and build configurations.
- Flags legacy configuration files that require manual migration for user review.
- Verifies the migration through targeted search and language-specific test execution.
- Ensures safe file system operations by requiring explicit confirmation of the target root.
When to use it
- When upgrading an existing project from NeMo Flow to NeMo Relay.
- When updating documentation or examples to reflect the NeMo Relay branding and API structure.
- When migrating cross-language repositories that contain Python, Rust, Node.js, or Go code.
- When needing to update CLI configurations or environment variables from NeMo Flow to NeMo Relay.
Advantages
- Reduces manual effort for large-scale codebase renames.
- Provides a safe, review-first approach with dry-run capabilities.
- Supports a wide range of languages and integration surfaces.
- Prevents accidental modification of sensitive or project-local configuration files.
- Includes built-in verification steps to ensure code integrity post-migration.
Usage examples
- “I need to migrate my project at /home/user/my-app from NeMo Flow to NeMo Relay. How do I start?”
- The agent will guide you to set the SKILL_DIR and TARGET_PATH variables, then execute the migration script in dry-run mode to generate a report of all pending changes for your review.
- “I have reviewed the dry-run report for my migration. How do I apply the changes?”
- The agent will instruct you to run the migration script with the --write and --confirm-root flags to safely apply the renames and edits to your project files.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/nvidia/nemo-relay-migrate-from-flow/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip nemo-relay-migrate-from-flow.zip -d .agents/skills
Documentation by NVIDIA Corporation and Affiliates
Migrate From NeMo Flow To NeMo Relay
Use this skill when a user has existing NeMo Flow code or documentation and wants it converted to NeMo Relay. Treat the migration as a mechanical rename plus language-specific validation, not a behavior rewrite. Keep compatibility exceptions explicit before applying broad renames.
Default Workflow
Inspect the working tree and identify touched surfaces: Rust, Python, Node.js, Go, C FFI, CLI/config, docs, or integrations.
Resolve
SKILL_DIRto the absolute directory containing thisSKILL.mdandTARGET_PATHto the source repository or target project. Run the bundled helper in dry-run mode before editing:python3 "$SKILL_DIR/scripts/migrate_from_nemo_flow.py" "$TARGET_PATH" --rename-pathsReview the reported text edits, path renames, and legacy project configuration warnings with the user. Do not migrate project-local
.nemo-flow/config.tomlor.nemo-flow/plugins.tomlinto.nemo-relay. Move those settings manually to a supported user or explicit configuration path after review.Obtain explicit confirmation for the resolved target root, then rerun with
--write,--rename-paths, and--confirm-root "$TARGET_PATH".Apply language-specific cleanup for package manager lockfiles, generated artifacts, and public API examples.
Search for remaining Flow names and verify the affected language surfaces.
Mechanical Rename Map
Brand and repository:
NeMo Flow->NeMo Relay,NeMo-Flow->NeMo-RelayPython:
nemo-flow->nemo-relay,nemo_flow->nemo_relay,python/nemo_flow->python/nemo_relayRust:
nemo-flow->nemo-relay,nemo-flow-adaptive->nemo-relay-adaptive,nemo_flow::->nemo_relay::Node.js:
nemo-flow-node->nemo-relay-node, including related entry points such as/typed,/plugin,/adaptive, and/observabilityGo:
github.com/NVIDIA/NeMo-Flow/go/nemo_flow->github.com/NVIDIA/NeMo-Relay/go/nemo_relay, package aliasesnemo_flow->nemo_relay, and source directoriesgo/nemo_flow->go/nemo_relayC FFI:
nemo_flow.h->nemo_relay.h,nemo_flow_*->nemo_relay_*,NemoFlow*->NemoRelay*, andNEMO_FLOW_*->NEMO_RELAY_*CLI/config:
nemo-flow->nemo-relay,~/.config/nemo-flow->~/.config/nemo-relay,NEMO_FLOW_*->NEMO_RELAY_*, andx-nemo-flow-*->x-nemo-relay-*. Do not blindly rename project-local.nemo-flow/config.tomlor.nemo-flow/plugins.tomlinto.nemo-relay; those files require manual migration to a supported user or explicit configuration path.
Do not replace bare flow, Flow, or FlowError. Those can be domain words
or intentional compatibility names.
Language Cleanup
Python: update
pyproject.toml, imports, type stubs, integration package paths, extras, and native module names. Regenerate or refresh lockfiles with the user's package workflow after source edits.Rust: update
Cargo.tomlcrate names, workspace dependencies, package references, anduse nemo_relay::...imports. Let Cargo regenerateCargo.lockwhen dependencies changed.Node.js: update
package.json, workspace names, package-lock entries, native addon artifact names, and imports fromnemo-relay-node. Run the package manager to refresh locks.Go: update
go.mod, import paths, package declarations, aliases, and any local directory layout undergo/nemo_relay.C FFI: update header includes, exported symbol names, status and callback type names, macro constants, loader paths, and downstream bindings.
Docs and examples: update badges, package install commands, repository links, hosted docs URLs, CLI commands, config paths, and integration names.
Automation Helper
Use $SKILL_DIR/scripts/migrate_from_nemo_flow.py for first-pass edits. The
helper:
runs as a dry run unless
--writeis passedskips common vendor, build, cache, and generated directories
skips lockfiles unless
--include-lockfilesis passedskips symbolic links and credential-bearing dotenv files
detects project-local
.nemo-flow/config.tomland.nemo-flow/plugins.toml, leaves them unchanged, and reports that they require manual migration to a supported user or explicit configuration pathrequires the reviewed target root to be repeated with
--confirm-rootbefore writing, and refuses filesystem-root or home-directory writesanchors writes and renames to verified directory handles without following symbolic links, and refuses write mode on platforms that cannot provide those guarantees
uses atomic no-replace path renames and exits nonzero when any requested mutation fails
can report or perform path renames with
--rename-pathsrewrites only explicit NeMo Flow identifiers, package names, repository names, config paths, headers, environment variables, and FFI type prefixes
The helper does not classify arbitrary JSON, YAML, TOML, or INI files as secret.
Review every configuration file in the dry-run report. If any reported file is
unreviewed or credential-bearing, do not use --write on that root. Apply the
reviewed changes manually and leave secret-bearing files untouched without
reading or displaying their values.
Set shell-safe absolute paths before invoking the helper. Replace the example values with the resolved skill directory and either the source repository or the user's target project:
SKILL_DIR="/resolved/absolute/path/to/nemo-relay-migrate-from-flow"
TARGET_PATH="/resolved/absolute/path/to/target-project"
python3 "$SKILL_DIR/scripts/migrate_from_nemo_flow.py" "$TARGET_PATH" --rename-paths
python3 "$SKILL_DIR/scripts/migrate_from_nemo_flow.py" "$TARGET_PATH" \
--write --rename-paths --confirm-root "$TARGET_PATH"Use --include-lockfiles only when the user wants lockfiles edited directly;
otherwise regenerate them with Cargo, uv/pip, npm, or Go tooling.
Verification
Search for remaining explicit Flow identifiers:
rg -n "NeMo Flow|NeMo-Flow|nemo_flow|nemo-flow|NEMO_FLOW|NemoFlow|nemo_flow\\.h|nemo_flow_"Run targeted tests for every affected language surface.
For Rust changes, run
cargo testor the repository's Rust test recipe.For Python changes, run the relevant import check and tests in the target environment.
For Node.js changes, run package install, type checks, and package tests.
For Go changes, run
go test ./...from the updated module.For docs-only migrations, build or link-check docs if the site navigation, install commands, or API references changed.
Related Skills
nemo-relay-get-startednemo-relay-instrument-callsnemo-relay-debug-runtime-integration
Files
- ATTRIBUTION.mdAdded by AutoGineer969 B
- BENCHMARK.md4.7 KiB
- LICENSELicence file added by AutoGineer11.2 KiB
- SKILL.md6.9 KiB
- evals/evals.json7.6 KiB
- scripts/migrate_from_nemo_flow.pyScript23.5 KiB
- skill-card.md4.0 KiB
- skill.oms.sig4.7 KiB
evals/evals.json
[
{
"id": "nemo-relay-migrate-from-flow-001",
"question": "I need to use the nemo-relay-migrate-from-flow skill to convert my project from NeMo Flow to NeMo Relay. My codebase is in /home/user/myproject and includes Python, Rust, and Node.js components. Can you run the migration?",
"expected_skill": "nemo-relay-migrate-from-flow",
"expected_script": "migrate_from_nemo_flow.py",
"ground_truth": "The agent used nemo-relay-migrate-from-flow to perform a dry-run migration on /home/user/myproject, reported the proposed text edits and path renames across Python, Rust, and Node.js surfaces, and then applied the changes with --write --rename-paths after confirming scope with the user.",
"expected_behavior": [
"The agent read the nemo-relay-migrate-from-flow SKILL.md to understand the workflow before executing",
"The agent executed migrate_from_nemo_flow.py in dry-run mode first on /home/user/myproject with --rename-paths",
"The agent reviewed the dry-run output with the user and then reran with --write --rename-paths and --confirm-root set to /home/user/myproject",
"The helper anchored writes and renames to the confirmed root with directory handles and refused write mode when no-follow directory operations were unavailable",
"The agent mentioned language-specific cleanup steps for Python pyproject.toml, Rust Cargo.toml, and Node.js package.json lockfile regeneration",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-migrate-from-flow-002",
"question": "I have a Python package that imports from nemo_flow and my pyproject.toml lists nemo-flow as a dependency. I also have some Go code importing github.com/NVIDIA/NeMo-Flow/go/nemo_flow. I need all of these renamed to the new Relay branding. Can you automate this?",
"expected_skill": "nemo-relay-migrate-from-flow",
"expected_script": "migrate_from_nemo_flow.py",
"ground_truth": "The agent identified this as a NeMo Flow to NeMo Relay migration task, ran the migration script to rename Python imports from nemo_flow to nemo_relay, updated pyproject.toml dependency from nemo-flow to nemo-relay, converted Go import paths from github.com/NVIDIA/NeMo-Flow/go/nemo_flow to github.com/NVIDIA/NeMo-Relay/go/nemo_relay, and advised on lockfile regeneration.",
"expected_behavior": [
"The agent executed migrate_from_nemo_flow.py targeting the user's project directory in dry-run mode to preview changes",
"The agent confirmed that Python imports (nemo_flow -> nemo_relay) and Go import paths would be updated correctly",
"The agent applied the migration with --write --rename-paths and an exact --confirm-root after reviewing the dry-run output with the user",
"The agent advised the user to regenerate Python lockfiles and run go mod tidy for Go module cleanup",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-migrate-from-flow-003",
"question": "We're doing a company-wide rebrand from NeMo Flow to NeMo Relay. I have a monorepo with Rust crates (nemo-flow, nemo-flow-adaptive), a C FFI header (nemo_flow.h with NEMO_FLOW_* macros and NemoFlow* types), CLI configs in ~/.config/nemo-flow, environment variables like NEMO_FLOW_API_KEY, and documentation referencing NeMo Flow throughout. The repo is at ./nemo-platform. Please migrate everything but leave bare 'flow' and 'Flow' words alone.",
"expected_skill": "nemo-relay-migrate-from-flow",
"expected_script": "migrate_from_nemo_flow.py",
"ground_truth": "The agent performed a comprehensive migration across all surfaces in the monorepo: renamed Rust crates from nemo-flow/nemo-flow-adaptive to nemo-relay/nemo-relay-adaptive, updated C FFI header from nemo_flow.h to nemo_relay.h including all NEMO_FLOW_* macros and NemoFlow* types, updated CLI config paths and environment variable references, updated documentation branding, and preserved bare 'flow'/'Flow' occurrences as instructed by the skill's rules.",
"expected_behavior": [
"The agent ran migrate_from_nemo_flow.py on ./nemo-platform in dry-run mode with --rename-paths to identify all affected surfaces",
"The agent verified that bare 'flow', 'Flow', and 'FlowError' terms were not being replaced in the dry-run output",
"The agent applied the migration with --write --rename-paths and an exact --confirm-root covering Rust, C FFI, CLI/config, and documentation surfaces",
"The agent left credential-bearing dotenv files and symbolic links untouched, migrated references only in source, documentation, and configuration files reviewed as non-secret, and did not use --write when the dry run included unreviewed or secret-bearing configuration",
"The helper prevented parent-directory symbolic-link swaps from redirecting writes or renames outside the confirmed root",
"The agent recommended letting Cargo regenerate Cargo.lock and noted that downstream C bindings may need manual header include updates",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-migrate-from-flow-004",
"question": "How do I configure NeMo Relay to increase the maximum token throughput for my inference pipeline? I'm seeing bottlenecks at around 5000 tokens per second and want to tune the batching parameters.",
"expected_skill": null,
"expected_script": null,
"ground_truth": "The agent recognized this as a performance tuning question about NeMo Relay's inference configuration, not a migration request from NeMo Flow, and provided guidance on throughput optimization or directed the user to relevant NeMo Relay documentation for batching configuration.",
"expected_behavior": [
"The agent did not invoke migrate_from_nemo_flow.py since this is not a migration task",
"The agent addressed the user's question about NeMo Relay throughput tuning and batching parameters",
"The agent did not reference the nemo-relay-migrate-from-flow skill or suggest renaming anything",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-migrate-from-flow-005",
"question": "Migrate this repo from NeMo Flow to NeMo Relay. It has legacy project-local .nemo-flow/config.toml and .nemo-flow/plugins.toml files from the old setup.",
"expected_skill": "nemo-relay-migrate-from-flow",
"expected_script": "migrate_from_nemo_flow.py",
"ground_truth": "The agent runs the migration helper in dry-run mode, reports that project-local .nemo-flow/config.toml and .nemo-flow/plugins.toml require manual migration to a supported user or explicit Relay configuration path, and does not rename them into unsupported .nemo-relay project configuration.",
"expected_behavior": [
"The agent runs migrate_from_nemo_flow.py in dry-run mode before any write",
"The helper reports legacy project-local config.toml and plugins.toml as manual migration items",
"The agent does not apply a .nemo-flow to .nemo-relay directory rename for project-local configuration",
"The agent tells the user to move reviewed settings to supported user or explicit Relay configuration",
"The agent can still migrate unrelated NeMo Flow source identifiers and safe path names after confirmation",
"The agent does not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
}
]
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Needs: Needs Python, Needs Node.js
Security
What our scanner noticed· Medium risk
- Large base64-encoded blobs
- Scripts that your agent may run
This skill includes scripts that your agent may run. Read them before you use it.
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- NVIDIA Corporation and Affiliates
- Publisher
- NVIDIA (Official)
- Source
- NVIDIA/skills · skills/nemo-relay-migrate-from-flow · commit fce3cca
- Licence
- Apache License 2.0 (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE-APACHE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by NVIDIA Corporation and Affiliates or NVIDIA.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download nemo-relay-migrate-from-flow.zip