TinyHumans SDK

SDKs and tools for integrating with the TinyHumans backend.

This repository mirrors the SDK layout used by ../tiny.place/frontend/sdk: a top-level documentation and examples surface, a CLI, and language bindings for TypeScript, Python, and Rust.

Contents

Path	What it is
api/tinyhumans.backend.json	Shared backend namespace manifest derived from the deployed Swagger spec
docs/	Integration docs, API surface, auth, and CLI usage
examples/	Small cross-language examples
sdk/typescript/	TypeScript SDK and tinyhumans CLI
sdk/python/	Python SDK
sdk/rust/	Rust SDK crate

Quick Start

pnpm --filter @tinyhumansai/sdk build
pnpm --filter @tinyhumansai/sdk exec tinyhumans health --base-url https://api.tinyhumans.ai

import { TinyHumansClient } from "@tinyhumansai/sdk";

const client = new TinyHumansClient({
  baseUrl: "https://api.tinyhumans.ai",
  token: process.env.TINYHUMANS_TOKEN,
});

const models = await client.inference.listModels();
const me = await client.auth.me();

import os
from tinyhumans import TinyHumansClient

client = TinyHumansClient(
    base_url="https://api.tinyhumans.ai",
    token=os.environ.get("TINYHUMANS_TOKEN"),
)
print(client.inference.list_models())

use tinyhumans_sdk::TinyHumansClient;

# async fn run() -> Result<(), tinyhumans_sdk::Error> {
let client = TinyHumansClient::new("https://api.tinyhumans.ai")
    .with_token(std::env::var("TINYHUMANS_TOKEN").ok());
let models = client.inference().list_models().await?;
# Ok(())
# }

Backend Surface

The SDKs are grounded in the deployed backend OpenAPI document: https://api.tinyhumans.ai/swagger.json. The live spec advertises TinyHumans API 1.0.0, production and staging servers, and 172 paths. Every SDK provides one typed method per deployed operation — 156 operations across 17 namespaces:

• Health and documentation: /, /swagger.json
• Auth and account state: /auth
• Inference and OpenAI-compatible routes: /openai
• Agent integrations: /agent-integrations
• Payments, credits, coupons, referrals, invites, and rewards
• Feedback, teams, channels, mascots, announcements, and investors routes
• Redirects and webhook ingress routes for provider callbacks

Each SDK also exposes a raw request helper so newly deployed backend endpoints can be used before a typed method is added.