Skip to main content
Use this page when a teammate needs a reliable local setup before running the quickstart or writing SDK code.

Pick Your Shell

macOS Or Linux: bash/zsh

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install "nullspace-sdk[cli]==0.1.9"

macOS Or Linux: fish

python3 -m venv .venv
source .venv/bin/activate.fish
python -m pip install --upgrade pip
python -m pip install "nullspace-sdk[cli]==0.1.9"

Windows: PowerShell

py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install "nullspace-sdk[cli]==0.1.9"
If activation is blocked in the current PowerShell process:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\.venv\Scripts\Activate.ps1

Windows: cmd

py -3.11 -m venv .venv
.venv\Scripts\activate.bat
python -m pip install --upgrade pip
python -m pip install "nullspace-sdk[cli]==0.1.9"

uv

uv venv
source .venv/bin/activate
uv pip install "nullspace-sdk[cli]==0.1.9"
On Windows PowerShell with uv, activate with:
uv venv
.\.venv\Scripts\Activate.ps1
uv pip install "nullspace-sdk[cli]==0.1.9"

Save Credentials Once

Use auth login for local development so you do not need to copy environment variables between shell tabs:
nullspace auth login --api-url https://api.13-215-85-171.sslip.io
nullspace doctor
The CLI prompts for the API key and stores it in local Nullspace config. For automation, CI, or agents that inherit environment variables, set:
export NULLSPACE_API_KEY=ns_live_...
export NULLSPACE_API_URL=https://api.13-215-85-171.sslip.io

Verify

nullspace --version
nullspace doctor
nullspace quickstart --no-wait
If doctor cannot find credentials, check the active shell first. Virtual environment activation and exported environment variables only apply to the terminal session where you ran them.

Next Steps