Implementation:Helicone Helicone Nvm Node Setup

Knowledge Sources	Helicone
Domains	Local Development, Node.js
Last Updated	2026-02-14 00:00 GMT

Overview

Concrete tool for installing Node.js 22 via NVM and setting up Python 3 for ClickHouse migrations, provided by the system shell and NVM.

Description

The Helicone monorepo requires Node.js >= 20 (specified in package.json line 12-14 and web/package.json line 5-7). The recommended approach is to use NVM (Node Version Manager) to install Node 22. Additionally, Python 3 is required for running ClickHouse schema migrations via ch_hcone.py, and Docker must be available for running the infrastructure stack.

Usage

Use these commands once when first setting up a development machine, or when switching to the Helicone project from another project that uses a different Node.js version.

Code Reference

Source Location

• Repository: Helicone
• File: package.json (lines 12-14), FULL_AGENT_LOOP.md (lines 5-21)

Signature

nvm install 22 && nvm use 22

Import

# Install NVM (if not already installed)
# See https://github.com/nvm-sh/nvm for full installation instructions
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Docker must be installed separately
# See https://docs.docker.com/get-docker/

I/O Contract

Inputs

Name	Type	Required	Description
Node version	integer	Yes	The major Node.js version to install (22 recommended, minimum 20)
Python 3	binary	Yes	Python 3.x must be on the system PATH for ClickHouse migrations
Docker	binary	Yes	Docker engine must be installed and the daemon running

Outputs

Name	Type	Description
node	binary	Node.js runtime available at the requested version
npm	binary	npm package manager bundled with Node.js
python3	binary	Python 3 interpreter available on PATH
docker	binary	Docker CLI and daemon confirmed running

Usage Examples

Basic Usage

# Install and activate Node.js 22 via NVM
nvm install 22
nvm use 22

# Verify Node.js version
node --version
# Expected: v22.x.x

# Verify npm is available
npm --version

# Install Yarn if not already available
npm install -g yarn

Python Setup for ClickHouse Migrations

# Create a Python virtual environment
python3 -m venv venv
source venv/bin/activate

# Install required Python packages
python3 -m pip install tabulate yarl

Verify Docker Is Running

# Confirm Docker daemon is running
docker info

# Confirm Docker Compose is available
docker compose version

Related Pages

Implements Principle

• Principle:Helicone_Helicone_Prerequisites_Installation

Requires Environment

• Environment:Helicone_Helicone_Node_20_TypeScript_Runtime