Create Node

Provisioning a node on nodepick.ai takes less than 30 seconds. You can create a node using the Python CLI (np), Python SDK, or HTTP API. All three methods provision the same underlying compute.

Provision a Node

Python CLI
Python SDK
HTTP API

Use the np command-line tool to deploy a new compute node from your terminal:

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

You can customize the node’s resources using flags such as --cpu, --memory, --storage, and --network:

np node create --name compute-node --cpu 2 --memory 2048 --storage 20

Use the Python SDK to create nodes programmatically. This is ideal for automated pipelines, scripts, or applications that need to spin up compute on demand.Install the SDK if you haven’t already:

pip install nodepick

Then create a node with a single call:

from nodepick import nodepick

client = nodepick(api_key="YOUR_API_KEY")

# Create a new node
node = client.create_node(display_name="my-first-node")
print(f"Node ID: {node['id']}")
print(f"Status: {node['status']}")

The create_node() call returns immediately with the node’s initial details. Poll client.get_node_details(node['id']) if you need to wait for the node to reach running status before proceeding.

You can create a node by sending a POST request to the nodepick.ai API. This works from any language or tool that supports HTTP.

curl -X POST https://api.nodepick.ai/nodes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Replace YOUR_API_KEY with your nodepick.ai API key, which you can find in your Developer Settings.

Expected Response

When you deploy a node with np node create and inspect it with np node get, the CLI outputs the node creation confirmation and details:

$ np node create --name my-first-node --cpu 1 --memory 512
Creating node...
Node created successfully! ID: c3ae2de0-be37-47f8-b9d2-1ec15ab95997

$ np node get my-first-node
┏━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Field       ┃ Value                                    ┃
┡━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ ID          │ c3ae2de0-be37-47f8-b9d2-1ec15ab95997     │
│ Org ID      │ org_01KZHF48NPJZVR0CARK9829VED           │
│ User ID     │ user_01KZHCPH4S4WMED0R9CGKHVMBC          │
│ Server ID   │ 35d4719f-8b52-4103-88fc-078634228f8e     │
│ Name        │ my-first-node                            │
│ State       │ Running                                  │
│ Status      │ active                                   │
│ SSH Connect │ ssh nodepick@fmt1-sr5.entic.net -p 10006 │
│ Region      │ us-west-1                                │
└─────────────┴──────────────────────────────────────────┘

Field	Description
`ID`	The unique VM UUID for your compute node. Use this ID to inspect, manage, or delete the node.
`Org ID`	Organization identifier associated with your account.
`User ID`	Account identifier of the user who provisioned the node.
`Server ID`	Identifier of the underlying host server.
`Name`	Display name assigned to the node (`my-first-node`).
`State`	Current execution state of the node (`Running`).
`Status`	Operational status of the node (`active`).
`SSH Connect`	Ready-to-use SSH connection command string.
`Region`	Geographic region where the node is hosted (`us-west-1`).

Billing starts the moment a node is created, even while it is still in the provisioning state. To avoid unnecessary charges, delete nodes as soon as you no longer need them.

Next Steps

Now that your node is provisioned, you’re ready to use it.

Manage Nodes

List your nodes, inspect their details, control power, and delete them when done.

CLI Reference

View complete node management flags and commands for the np CLI.

Get Started

Managing Compute

Provision a Node

Expected Response

Next Steps

Manage Nodes

CLI Reference

​Provision a Node

​Expected Response

​Next Steps

Manage Nodes

CLI Reference

Provision a Node

Expected Response

Next Steps