DocumentationReferenceCLI Reference

Troubleshooting

View as Markdown

This page covers common issues and how to resolve them.

Command Not Found

Unknown command: nemo

Symptoms:

  • nemo: command not found
  • Unknown command: nemo

Cause:

If you installed nemo-platform with pip or uv pip, it was installed in a virtual environment. The nemo command is only available when that environment is activated.

Solution:

Activate the virtual environment where you installed the package:

$source /path/to/venv/bin/activate

Installation Issues

Install Fails Building a Dependency

Symptoms:

  • uv tool install "nemo-platform[all]" fails while building a dependency, often on a missing C header such as omp.h

Cause:

NeMo Platform supports Python 3.12 and 3.13, but uv picks the interpreter itself, so an install can land on Python 3.14.

Solution:

Name a supported interpreter. uv downloads one if you do not have it:

$uv tool install --python 3.13 "nemo-platform[all]"

Connection Issues

Unable to Connect to Server

Symptoms:

  • Connection refused or Connection timed out errors
  • Commands hang or fail with network errors

Solutions:

  1. Verify the base URL is correct:

    $nemo config view

  2. Check that the server is reachable:

    $curl <your-base-url>/health

  3. If running locally, ensure services are up:

    $curl -s http://localhost:8080/health/ready

Authentication Errors

Symptoms:

  • 401 Unauthorized or 403 Forbidden errors
  • Invalid API key messages

Solutions:

  1. Verify your credentials are configured:

    $nemo config view

  2. Re-configure the connection:

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

  3. Check that your API key is valid and has the required permissions.

Debugging

Enable Verbose Output

Use the --verbose flag to see detailed information about what the CLI is doing:

$nemo --verbose workspaces list

This shows:

  • API requests being made
  • Response details
  • Configuration values being used

Check Current Configuration

View your full configuration to verify settings:

$nemo config view

Getting Help

  • Use --help on any command for usage information
  • See the reference for complete command documentation
  • See configuration for detailed configuration options