Quickstart (CLI) - nodepick.ai Documentation

Get up and running with the nodepick.ai command-line tool (np) in less than a minute. Deploy and manage compute nodes directly from your terminal.

Billing is calculated per-second. It starts the moment your node is created and stops the moment you delete it.

Install the CLI

Install the np CLI using uv (recommended) or pip:

uv tool install nodepick-cli

pip install nodepick-cli

Authenticate Your Account

Save your API key securely in your OS keyring using np auth save:

np auth save --api-key YOUR_API_KEY

Verify access and display your account details:

np auth test

Add an SSH Public Key (Optional)

np ssh add --name my-key --file ~/.ssh/id_ed25519.pub

Deploy Your First Node

Create a new compute node with a single command:

np node create --name my-first-node --cpu 1 --memory 512

Your node is provisioned and ready in seconds.

Connect via SSH

List your nodes to retrieve the SSH connection command:

np node list

Alternatively, inspect detailed information for your specific node:

np node get my-first-node

Run the printed SSH command to connect to your node:

ssh nodepick@<hostname> -p <port>

Clean Up

When you finish, delete the node to terminate billing immediately:

np node delete my-first-node

Command Cheat Sheet

# Authenticate
np auth save --api-key YOUR_API_KEY
np auth test

# Register SSH Key
np ssh add --name dev-key --file ~/.ssh/id_ed25519.pub

# Manage Nodes
np node create --name dev-server --cpu 2 --memory 1024
np node list
np node get dev-server
np node shutdown dev-server
np node boot dev-server
np node delete dev-server

Next Steps

CLI Reference

Explore all CLI subcommands, global options, and output formats.

Quick Start (API)

Learn how to manage compute nodes programmatically using Python SDK or HTTP API.

​Command Cheat Sheet

​Next Steps

CLI Reference

Quick Start (API)

Command Cheat Sheet

Next Steps