Developer Quickstart

What You'll Build

In this quickstart, you'll:

By the end, you'll have a working foundation for building Human-AI Orchestration (HAIO) applications.

Prerequisites

Step 1: Install the SDK

Choose your language:

Step 2: Initialize the Client

Set up your API client with your key:

Step 3: Create Your First Passport

A Passport is a cryptographic identity — think of it as a portable, verifiable ID for humans, organizations, or AI agents.

Step 4: Create an Agent Passport

Now create a Passport for an AI agent that will act on Alice's behalf:

Step 5: Delegate Access to the Agent

Now Alice delegates access to the agent — giving it permission to act on her behalf with specific constraints:

Step 6: Orchestrate a Workflow

Now use HumanOS to orchestrate a multi-step workflow. HumanOS will automatically route tasks to agents based on their capabilities:

const workflow = await client.humanos.orchestrate({
  task: 'Process 50 invoices from Acme Corp and generate a financial summary',
  requiredCapabilities: ['invoice_processing', 'financial_analysis'],
  context: {
    invoiceCount: 50,
    organization: 'Acme Corp',
    priority: 'high',
  },
  humanInLoop: true, // Require human approval before execution
});

console.log('✅ Workflow started!');
console.log('Workflow ID:', workflow.workflowId);
console.log('Status:', workflow.status);
console.log('Assigned agents:', workflow.assignedAgents);

// Check status
const status = await client.humanos.getWorkflow(workflow.workflowId);
console.log('Current step:', status.currentStep);
console.log('Progress:', `${status.completedSteps}/${status.totalSteps}`);

What's Next?