Installation

Install the SDK

npm install @sidclaw/sdk

Requirements

Node.js 18+ (uses the built-in fetch API)
TypeScript is recommended but not required. The SDK ships with full type definitions.

Package Exports

The SDK provides a main entry point and several subpath exports for framework integrations:

Import path	Description
`@sidclaw/sdk`	Core client, `withGovernance`, error classes, types
`@sidclaw/sdk/mcp`	MCP governance server and proxy
`@sidclaw/sdk/nemoclaw`	NVIDIA NemoClaw sandbox governance
`@sidclaw/sdk/langchain`	LangChain.js tool governance wrappers
`@sidclaw/sdk/openai-agents`	OpenAI Agents SDK tool governance wrappers
`@sidclaw/sdk/claude-agent-sdk`	Anthropic Claude Agent SDK tool governance
`@sidclaw/sdk/google-adk`	Google ADK tool governance
`@sidclaw/sdk/crewai`	CrewAI tool governance wrappers
`@sidclaw/sdk/composio`	Composio managed tool governance
`@sidclaw/sdk/llamaindex`	LlamaIndex tool governance
`@sidclaw/sdk/vercel-ai`	Vercel AI SDK tool governance wrappers
`@sidclaw/sdk/webhooks`	Webhook signature verification
`@sidclaw/sdk/github`	GitHub Action governance checks

Verify Installation

import { AgentIdentityClient } from '@sidclaw/sdk';

const client = new AgentIdentityClient({
  apiKey: process.env.SIDCLAW_API_KEY!,
  apiUrl: 'https://api.sidclaw.com',
  agentId: 'your-agent-id',
});

console.log('SDK loaded successfully');

Python

pip install sidclaw

With framework integrations:

pip install sidclaw[langchain]      # LangChain / LangGraph
pip install sidclaw[crewai]         # CrewAI
pip install sidclaw[openai-agents]  # OpenAI Agents SDK
pip install sidclaw[pydantic-ai]    # Pydantic AI
pip install sidclaw[mcp]            # MCP governance proxy
pip install sidclaw[all]            # Everything

Requirements

Python 3.10+
Both sync and async clients are provided. The SDK ships with full type annotations (PEP 484).

Package Extras

Install extra	Description
`sidclaw`	Core client, `with_governance`, error classes, types
`sidclaw[langchain]`	LangChain / LangGraph tool governance wrappers
`sidclaw[crewai]`	CrewAI tool governance wrappers
`sidclaw[openai-agents]`	OpenAI Agents SDK tool governance wrappers
`sidclaw[pydantic-ai]`	Pydantic AI governance dependency
`sidclaw[mcp]`	MCP governance proxy server
`sidclaw[all]`	All framework integrations

Verify Installation

from sidclaw import SidClaw

client = SidClaw(
    api_key="ai_...",
    base_url="https://api.sidclaw.com",
    agent_id="your-agent-id",
)

print("SDK loaded successfully")

Environment Variables

The SDK itself does not read environment variables automatically. You pass configuration directly to the client constructor. However, we recommend storing secrets in environment variables:

# .env
SIDCLAW_API_KEY=ai_...
AGENT_IDENTITY_API_URL=https://api.sidclaw.com
AGENT_IDENTITY_AGENT_ID=ag_...

Then reference them in your code:

const client = new AgentIdentityClient({
  apiKey: process.env.SIDCLAW_API_KEY!,
  apiUrl: process.env.AGENT_IDENTITY_API_URL!,
  agentId: process.env.AGENT_IDENTITY_AGENT_ID!,
});

Python:

import os
from sidclaw import SidClaw

client = SidClaw(
    api_key=os.environ["SIDCLAW_API_KEY"],
    base_url=os.environ["AGENT_IDENTITY_API_URL"],
    agent_id=os.environ["AGENT_IDENTITY_AGENT_ID"],
)

Installation

On this page