NeMo Platform CLI#

The NeMo Platform CLI (nmp) is a command-line tool for interacting with NeMo Platform. It provides a unified interface for managing models, running jobs, deploying inference endpoints, and working with the local quickstart environment.

Key Capabilities#

  • API Operations - Manage models, jobs, workspaces, and other resources

  • Local Deployment - Start and manage the quickstart environment with a single command

  • Multiple Output Formats - Table, JSON, YAML, CSV, and Markdown for integration with other tools

  • Context Management - Switch between multiple environments (dev, staging, prod) seamlessly

  • Shell Completion - Tab completion for Bash, Zsh, and Fish

Installation#

Note

This package downloads and installs additional third-party open source software projects. Review the license terms of these open source projects before use.

If you previously installed the nemo-microservices package, uninstall it first to avoid conflicts:

pip uninstall nemo-microservices

Install in a Virtual Environment#

pip install nemo-platform

Or with uv:

uv pip install nemo-platform

Warning

When installed in a virtual environment, the nmp command is only available when the environment is activated.

Verify Installation#

nmp --help

If you see Unknown command: nmp, see the Troubleshooting page.

Getting Started#

1. Configure the CLI#

Set up your connection:

nmp config set --base-url https://nmp.example.com
nmp auth login

2. Verify Your Connection#

nmp workspaces list

This command outputs a list of available workspaces. If the connection fails, see Troubleshooting for common issues and solutions.

Command Structure#

The CLI follows a consistent pattern:

nmp [GLOBAL OPTIONS] <command> [<subcommand>...] [OPTIONS]

Global options apply to all commands:

Option

Description

--context, -c

The name of the context to use. Overrides the current context in the config file.

--base-url

Base URL for the NeMo Platform API

--output-format, -f <CHOICE>

Output format for how results are printed. [possible values: table, json, yaml, markdown, csv, raw, code]

--no-truncate

Don’t truncate long values in table/markdown/csv output

--timestamp-format <CHOICE>

Timestamp format for table/markdown/csv output [possible values: relative, iso8601]

--verbose, -v

Enable verbose messaging. This only impacts logs that are visible, it doesn’t change any data outputs.

Commands are organized into categories:

Category

Commands

Description

Use cases

chat, wait

Higher-level workflows

Configuration

auth, config

Manage authentication and CLI settings

Deployment

quickstart, cluster-info

Manage local quickstart environment

API

audit, customization, data-designer, entities, evaluation, files, guardrail, iam, inference, jobs, members, models, projects, safe-synthesizer, secrets, workspaces

Interact with NeMo Platform APIs

Common Workflows#

Exploring Commands#

Use --help on any command to see available options and subcommands:

# See all available commands
nmp --help

# See subcommands for a specific resource
nmp models --help

# See options for a specific command
nmp models list --help

Local Deployment with Quickstart#

# Start the quickstart environment
nmp quickstart up

# Check status
nmp quickstart status

# View logs
nmp quickstart logs

# Stop the environment
nmp quickstart down

Integrating with Other Tools#

The CLI outputs JSON with -f json, making it easy to integrate with tools like jq, shell scripts, and CI/CD pipelines.

Filtering with jq#

# Get just the model names
nmp models list -f json | jq -r '.data[].name'

# Find models matching a pattern
nmp models list -f json | jq -r '.data[] | select(.name | contains("nvidia"))'

CSV Export#

# Export to CSV for spreadsheets
nmp models list -f csv --all-pages --no-truncate --output-columns all > models.csv

Next Steps#