Apache-2.0 · Open Source · on npm

Homeport SDK

The official TypeScript client for Homeport — the open-source, self-hostable NANDA node. Agent registration, A2A discovery, trust scoring, DAG workflow orchestration, and NANDA Index resolution on the open agentic web. Zero runtime dependencies. Edge-ready. Fully typed.

Open API reference View on GitHub ↗ View on npm ↗

pnpm add @nexartis/homeport-sdk

What is Homeport?

Homeport is the open-source, self-hostable NANDA ↗ node published by Nexartis. Networked AI Agents in Decentralized Architecture — the protocol that originated at MIT Media Lab ↗ — is DNS for AI agents: a decentralized layer for naming, trust, discovery, and orchestration on the agentic web.

A single Homeport instance provides the NANDA Index, .well-known/agent-card.json A2A endpoints, agent certification and reputation scoring, compliance auditing, webhook delivery, federation (CRDT gossip) with peer nodes, and a DAG orchestration engine for multi-agent workflows — all on Cloudflare Workers.

The Homeport runtime lives at github.com/Nexartis/homeport ↗. This SDK is the official TypeScript client for its API.

Built for production agent infrastructure

Zero runtime deps

Uses the platform fetch. Nothing to bundle, nothing to audit. Ships as typed ESM.

Edge-native

Runs on Cloudflare Workers, Node 20+, Bun, Deno, and modern browsers — no shims required.

Fully typed

End-to-end TypeScript with discriminated-union errors and namespaced APIs per Homeport capability.

Resilient by default

Automatic retries with backoff, per-endpoint circuit breaker, request deduplication, response caching.

OpenTelemetry ready

W3C Trace Context propagation out of the box. Drop it in a traced Worker and spans light up for free.

Transparent provenance

Published via OIDC Trusted Publishing with SLSA provenance attestations. No long-lived npm tokens.

Quickstart

import { HomeportClient } from '@nexartis/homeport-sdk';

const client = new HomeportClient({
  baseUrl: 'https://homeport.example.com',
  apiKey: process.env.HOMEPORT_API_KEY,
});

// Register an agent on the NANDA network
await client.agents.register({
  agent_id: 'my-code-review-agent',
  agent_url: 'https://my-agent.example.com',
  capabilities: ['code-review', 'security-audit'],
  trust_score: 0.9,
});

// Discover peers by capability (auto-paginating)
for await (const agent of client.agents.searchAll({ capabilities: ['code-review'] })) {
  console.log(agent.agent_id, agent.trust_score);
}

Explore every namespace in the API reference →

Deploy Homeport

Self-host Homeport, or let Cubicube run it for you

Homeport is open source: clone github.com/Nexartis/homeport ↗ and deploy it to your own Cloudflare account in minutes. Everything you need to stand up a NANDA node — index, A2A endpoints, federation, orchestrator — is in the box.

🌐 Bring your own domain & Cloudflare account
⚡ Runs on Cloudflare Workers — edge-native by default
🔐 Passwordless auth + role-based access control out of the box
📦 This SDK connects on day one — same typed client, hosted or self-hosted

Self-host Homeport ↗ Connect the SDK ↗

Prefer a managed node with custom domain & SSL provisioning, isolated tenants on Workers for Platforms, and one-click upgrades? Explore managed hosting on Cubicube ↗

Customizing the node itself? Homeport ships as a Cubicube Core Cubi — a manifest-honest fork stays one-command deployable, and a customization you build can be offered to Cubicube's customers. Read the distribution guide ↗