This is the minimum setup for a local shell or coding agent to use Nullspace. You need Python 3.11+ and a Nullspace API key.

​
1. Export Credentials

Use the API URL and key from your handout: 
export NULLSPACE_API_URL=https://api.your-nullspace-domain
export NULLSPACE_API_KEY=ns_live_...
For the current nbits single-host appliance: 
export NULLSPACE_API_URL=https://18.140.200.84.sslip.io
export NULLSPACE_API_KEY=ns_live_...
NULLSPACE_API_KEY is the runtime key used by the SDK, CLI, MCP server, and raw HTTP calls. Keep it out of committed files and shell history.

​
2. Install SDK And CLI

Create an isolated Python environment and install the published package: 
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install "nullspace-sdk[cli]"

uv venv
source .venv/bin/activate
uv pip install "nullspace-sdk[cli]"
The distribution is nullspace-sdk; the import package and CLI command are both named nullspace. Check that the CLI can see your environment: 
nullspace doctor

​
3. Install Agent Docs

Install the MCP extra when Codex, Claude Code, Cursor, VS Code, or another MCP client should call Nullspace tools: 
python -m pip install "nullspace-sdk[cli,mcp]"
Then install the project-local agent guide and MCP config: 
cd /path/to/your/project
nullspace docs install --agent all
This writes local agent docs, Codex/Claude Code skill files, managed AGENTS.md or CLAUDE.md blocks, and MCP configuration. It does not require an API key and does not store secrets. Start the coding agent from a shell where NULLSPACE_API_URL and NULLSPACE_API_KEY are exported.