Skip to main content

​
Getting Started

Complete guide to installing and configuring the Nevermined CLI.

​
Prerequisites

Before installing the CLI, ensure you have:
  • Node.js >= 18.0.0
  • npm or yarn package manager
  • A Nevermined account with API key

​
Getting Your API Key

To interact with the Nevermined API, you need an API key. Open nevermined.app, sign in, then go to Settings > Global NVM API Keys and click + New API Key.

​
Installation

Install the CLI globally to use the nvm command from anywhere: 
npm install -g @nevermined-io/cli
Verify installation: 
nvm --version

​
Option 2: Using npx (No Installation)

Run the CLI without installing: 
npx @nevermined-io/cli --help
This is useful for one-off commands or trying the CLI before installing.

​
Option 3: From Source

For development or contributing: 
# Clone the repository
git clone https://github.com/nevermined-io/payments
cd payments/cli

# Install dependencies
yarn install

# Build the project
yarn build:manifest

# Run the CLI
./bin/run.js --help

​
Authentication

The quickest way to authenticate: 
nvm login
This opens your browser to sign in with Google, X, or email. After login, your API key is automatically captured and saved to your CLI config. Options:
  • --environment <env> — Target environment (default: sandbox)
  • --profile <name> — Config profile to save to (default: default)
  • --no-browser — Print the login URL instead of opening the browser
Examples: 
nvm login --environment live
nvm login --profile production --environment live
nvm login --no-browser

​
Logout

Remove your API key from the CLI config: 
nvm logout
nvm logout --profile production
nvm logout --all-profiles

​
Configuration

​
Interactive Setup

The easiest way to configure the CLI is using the interactive setup: 
nvm config init
This will prompt you for:
  • NVM API Key: Your API key from nevermined.app
  • Environment: Choose from:
    • sandbox - Testing (recommended for learning and development)
    • live - Production environment
Example: 
$ nvm config init

? Enter your NVM API Key: sandbox:eyJxxxxaaaabbbbbbbb
? Select environment: sandbox

✅ Configuration saved to /home/user/.config/nvm/config.json

​
Configuration File

The CLI stores configuration in ~/.config/nvm/config.json: 
{
  "profiles": {
    "default": {
      "nvmApiKey": "live:eyJxxxxaaaabbbbbbbb",
      "environment": "live"
    }
  },
  "activeProfile": "default"
}

​
Multiple Profiles

Create multiple profiles for different environments or accounts: 
# Initialize with default profile
nvm config init

# Create a production profile
nvm config set profiles.production.nvmApiKey nvm-yyyyyyyy...
nvm config set profiles.production.environment live

# Switch active profile
nvm config set activeProfile production
Use a specific profile for a command: 
nvm --profile production plans get-plans

​
Environment Variables

Override configuration with environment variables: 
# Set API key
export NVM_API_KEY=sandbox:eyJxxxxaaaabbbbbbbb

# Set environment
export NVM_ENVIRONMENT=sandbox

# Run commands
nvm plans get-plans
This is useful for:
  • CI/CD pipelines
  • Temporary configuration changes
  • Scripting

​
View Configuration

Display your current configuration: 
nvm config show
Output: 
Current Configuration
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Active Profile: default
Environment:    sandbox
API Key:        live:eyJxxxxaaaabbbbbbbb (truncated)

​
Verify Setup

Test your configuration by listing available plans: 
nvm plans get-plans
If configured correctly, you should see a table of available payment plans.

​
Environment Guide

Choose the right environment for your use case:
EnvironmentUse CaseBlockchainPayments
sandboxDevelopment, learning, testingTest networkTest credits
liveProductionMainnetReal payments
Recommendation: Start with sandbox for development and testing.

​
Common Issues

​
”Command not found: nvm”

After global installation, if nvm command is not found:
  1. Verify installation: npm list -g @nevermined-io/cli
  2. Check your PATH includes npm global bin directory
  3. Restart your terminal
  4. Try using the full path: npx @nevermined-io/cli

​
”API Key not found”

If you get an API key error: 
# Browser login (recommended)
nvm login

# Or initialize configuration manually
nvm config init

# Or set environment variable
export NVM_API_KEY=your-api-key-here

​
Permission Errors

If you get permission errors during global installation: 
# Use npx instead
npx @nevermined-io/cli --help

# Or install without sudo using nvm/volta

​
Next Steps

Now that you’ve installed and configured the CLI, explore:
  • Plans - Create and manage payment plans
  • Agents - Register AI agents
  • Purchases - Order plans and make payments
  • Querying - Query agents with access tokens

​
Getting Help

Get help for any command: 
# General help
nvm --help

# Topic help
nvm plans --help

# Command help
nvm plans get-plan --help
For support: