NVIDIA Fleet Intelligence Client

View as Markdown

Overview

nvfleetint provides command-line and Go interfaces to NVIDIA Fleet Intelligence.

  • CLI: Use the nvfleetint executable to inspect fleet status, node health, inventory, alerts, events, and reports from a terminal or automation workflow.
  • Go SDK: Import github.com/NVIDIA/fleet-intelligence-client/nvfleetint to integrate Fleet Intelligence data into Go applications and services.

Both interfaces support fleet summaries, compute zones, node groups, nodes, health history, alerts, events, tags, inventory reports, and error reports.

Install

CLI

Linux and macOS

Install nvfleetint:

curl -fsSL https://github.com/NVIDIA/fleet-intelligence-client/releases/latest/download/install.sh | bash

The installer verifies the release checksum and, on macOS, the Developer ID signature and Apple notarization ticket before installing the executable. For publisher-authenticated verification using the signed checksum manifest, see Verify release artifacts.

Windows

Install nvfleetint:

irm https://github.com/NVIDIA/fleet-intelligence-client/releases/latest/download/install.ps1 | iex

Staying current

nvfleetint version checks GitHub for the newest published release and tells you when the installed build is behind. To upgrade:

nvfleetint upgrade

That runs the installer published with the new release, so it verifies the same checksum and code signature a fresh install does. To install a specific release instead of the newest one, name it:

nvfleetint upgrade --version v1.1.0

See Version and updates for the JSON output, the --yes flag for CI, and how to turn the check off.

Go SDK

Add the nvfleetint package to a Go module:

go get github.com/NVIDIA/fleet-intelligence-client/nvfleetint

See the Go SDK guide for client setup and usage.

Quick Start

Choose an NGC API key:

nvfleetint auth add     # prompts for the API key and API URL
nvfleetint overview
nvfleetint node list

auth add reads the API key from stdin rather than a flag.

Credentials are stored in named profiles; with no name, auth add uses one called default, so single-tenant setup is the one command above. To work against several tenants or endpoints, name them: add more with nvfleetint auth add <name>, switch the default with nvfleetint auth use <name>, and select one for a single command with --profile. Re-running auth add with an existing name changes that profile in place, which is how a key is rotated — press Enter at the key prompt to keep the stored key without ever displaying it (--yes covers replacing it from a script, where nothing can be confirmed):

nvfleetint auth add dev
nvfleetint node list --profile dev

Run nvfleetint <command> --help for command-specific flags.

AI Skills

Install the bundled Fleet Intelligence skills for Claude Code, Cursor, and Codex:

npx skills add NVIDIA/fleet-intelligence-client \
  --skill '*' \
  --agent claude-code --agent cursor --agent codex

Install and authenticate nvfleetint first. See Agent Skills for available skills and usage guidance.

Documentation

Full documentation is available at docs.nvidia.com/fleet-intel/client, including the CLI guide, Go SDK reference, architecture overview, and agent skills.

For the broader Fleet Intelligence platform documentation, see docs.nvidia.com/fleet-intel.

The OpenAPI contract is available in the repository.

Contributing

See CONTRIBUTING.md for development setup and guidelines.

Security

Report vulnerabilities through the security policy.

License

Apache License 2.0 - see LICENSE for details. Open a GitHub issue for support.