Installation

Applies to SDK 0.16+ · Last updated: 2026-06-12

System requirements

Requirement	Details
Node.js	v18 or later (for the CLI)
Python	v3.10 or later (for running packs and using the SDK)
npm	v9 or later
OS	macOS, Linux, Windows (WSL recommended on Windows)

Choose your install

Use case	Package	Install
Build agents & apps in Python	agentnode-sdk	pip install agentnode-sdk
CLI — search, install, publish	agentnode-sdk	pip install agentnode-sdk
Use with LangChain / LangGraph	agentnode-langchain	pip install agentnode-langchain
Use with MCP (Claude, Cursor)	agentnode-mcp	pip install agentnode-mcp

Install the CLI

The AgentNode CLI is included in the Python SDK. After installing the SDK, the agentnode command is available in your terminal.

terminal

$ pip install agentnode-sdk

Verify the installation:

terminal

$ agentnode --version

$ agentnode --help
Usage: agentnode <command> [options]

Commands:
  setup             Run setup wizard
  search            Search for packages
  resolve           Resolve capabilities to packages
  install           Install a package
  remove            Remove a package
  run               Run a capability or natural language task
  auth              Manage local credentials (own API tokens)
  audit             View policy decision audit trail
  doctor            Analyze setup and suggest improvements
  init              Create a new package from template
  validate          Validate a package before publishing
  verify-local      Run verification pipeline locally
  publish           Publish a package to the registry
  record-cases      Record VCR cassettes for verification
  inspect           Security report for an installed package
  discover          Browse trending and categorized packages
  recommend         Get capability recommendations
  capabilities      List installed capabilities
  config            View or modify settings
  logs              Show agent run logs

Authentication & API Keys

Who needs an account? Only publishers (people who want to upload packages) and users who install from the registry. Read-only operations like search, info, and explain work without any authentication.

Operation	Auth Required?	Who Uses This
search, info, explain	No	Anyone — explore the registry freely
install, resolve, update	Yes (API key)	Developers integrating packages into their agents
publish, validate	Yes (API key + publisher profile)	Package authors publishing to the registry
credentials list/test	Yes (API key)	Users managing server-side OAuth credentials
auth (local tokens)	No	Anyone — local credentials need no account

How to get an API key: Register an account on the website, then create an API key in your dashboard. The key is shown once at creation — save it immediately.

terminal

# Set the API key as an environment variable
$ export AGENTNODE_API_KEY=ank_live_abc123def456

# Or pass it per-command
$ agentnode publish . --token ank_live_abc123def456

# Or store it in config
# ~/.agentnode/config.json: { "api_key": "ank_..." }

API keys are stored locally in ~/.agentnode/config.json. The backend stores only a SHA-256 hash of your key — the plaintext is never persisted on the server. Keys can be revoked at any time from your account settings.