SDK Reference

Build on HUMΛN

Official SDKs for Python, TypeScript, and Go. Full type safety, IDE support, and production-ready.

The world built intelligence. Nobody built the infrastructure beneath it.

These SDKs are how you build on that infrastructure— identity, capability, orchestration, and provenance for every AI system you create. Focus on your business logic. We handle the trust layer.

Choose Your Language

Python SDK

Full-featured framework with decorator-based APIs and async support.

pip install human-sdk

TypeScript SDK

Type-safe SDK for Node.js, Deno, and edge runtimes. Full TypeScript support.

npm install @human/client-sdk

Go SDK

Lightweight SDK for containerized deployments and Kubernetes environments.

go get github.com/human/sdk

Core Concepts

All SDKs share the same core concepts and API surface:

• Passport - Create and manage cryptographic identities
• CapabilityGraph - Grant, verify, and query capabilities
• HumanOS - Orchestrate tasks, route by capability, enforce governance
• Provenance - Automatic audit logging for all actions

Quick Example

// TypeScript — HTTP Client SDK
import { HumanClient } from '@human/client-sdk';

const client = new HumanClient({ apiKey: process.env.HUMAN_API_KEY });

// Create a passport (cryptographic identity)
const passport = await client.passport.create({
  display_name: 'Alice',
  type: 'individual',
});

// Grant a capability with evidence
await client.capabilities.grant({
  passport_id: passport.id,
  capability: 'legal-analysis',
  evidence: [{ type: 'certification', source: 'bar-association', verified: true }],
});

// Start a workflow
const workflow = await client.workflows.start({
  name: 'contract-review',
  input: { document_url: 'https://example.com/contract.pdf' },
});

Common Patterns

Looking for copy-paste code? Check out our Patterns library with working examples for:

• Creating Passports
• Delegating to agents
• Granting capabilities with evidence
• Simple orchestration workflows
• Human-in-loop approval gates