@humanoidinc/sdk

JavaScript SDK and CLI for HumanoidInc — humanoid robotics market intelligence.

SDK Usage

import { HumanoidInc } from "@humanoidinc/sdk";

// Free tier (no API key)
const hi = new HumanoidInc();

// Paid tier
const hi = new HumanoidInc({ apiKey: "hum_..." });

// List companies
const { data } = await hi.companies.list({ q: "tesla" });

// Get company details
const { data } = await hi.companies.get("tesla");

// List robots
const { data } = await hi.robots.list({ use_case: "Manufacturing" });

// Get robot details
const { data } = await hi.robots.get("tesla_optimus");

// Market data (Team tier)
const { data } = await hi.market.get({ view: "global" });

// Search
const { data } = await hi.search.get("humanoid robot");

// Contribute data
await hi.contribute.robot({
  action: "create",
  entity_id: "new_robot",
  data: { name: "New Robot", ... },
  source: "https://...",
});

CLI Usage

# Set API key (optional — free tier works without)
export HUMANOIDINC_API_KEY=hum_...

# List companies
npx humanoidinc companies list
npx humanoidinc companies list --q tesla --country USA

# Get company details
npx humanoidinc companies get tesla

# List robots
npx humanoidinc robots list
npx humanoidinc robots list --use-case Manufacturing --readiness production

# Get robot details
npx humanoidinc robots get tesla_optimus

# Market data
npx humanoidinc market --view global

# Search
npx humanoidinc search "humanoid robot"

# Contribute data
npx humanoidinc contribute robot --data '{"action":"create","entity_id":"new_robot","data":{}}'

# Check contribution status
npx humanoidinc contribute status

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | HUMANOIDINC_API_KEY | No | API key for paid-tier access | | HUMANOIDINC_API_URL | No | API base URL (default: https://www.humanoidinc.com) |