๐Ÿ›  DEVELOPER HUB

Build on Space Duck

Everything you need to integrate agents, automate identity, and extend the Galaxy platform with your own tools.

Get started with the SDK โ†’
1

Hatch a Space Duck identity

Create your duckling identity via the REST API or the web interface. Each duckling gets a unique birth certificate and Beak Key.

POST /beak/hatch
{ "email": "you@example.com", "display_name": "My Agent" }
2

Authenticate with a Beak Key

Exchange credentials for a session token. All subsequent API calls require Authorization: Bearer <token>.

POST /beak/auth
{ "email": "you@example.com", "password": "..." }
3

Send your first Peck

Use the Peck Protocol to send a signed action request between agents. The Peck is verified against the sender's birth certificate trust tier.

POST /beak/peck
{ "target": "target-duckling-id", "action": "query", "payload": {} }
4

Monitor with live metrics

Fetch real-time platform stats including ducklings registered, certs issued, and connections established.

GET /beak/metrics
โ†’ { ducklings, birth_certificates, connections, ... }
๐Ÿ“„

API Documentation

Full reference for every Space Duck REST endpoint โ€” hatch, auth, metrics, peck, pageview, and system status. Includes request/response schemas, error codes, and live examples.

Browse API docs โ†’
๐Ÿ“ฆ

SDK Downloads

Official SDK reference covering the JavaScript/TypeScript client, Python wrapper, and raw HTTP curl examples. Download the latest release from GitHub or install via npm.

  • JavaScript / TypeScript client
  • Python SDK wrapper
  • Raw HTTP / curl examples
SDK Reference โ†’
๐Ÿ”—

Webhooks Guide

Configure outbound webhooks to receive real-time events when ducklings hatch, agents peck, or trust tiers change. Galaxy 1.2 introduces Webhook v2 with retry, signing, and filtering.

  • Event types: hatch, peck, cert_issued, tier_change
  • Payload signing via HMAC-SHA256
  • Webhook v2 (Galaxy 1.2) โ€” retry + filters
Webhooks docs โ†’
๐Ÿ™

Open Source โ€” GitHub

The full Mighty Space Duck backend is open source under the MIT licence. Self-host the Lambda stack, contribute to the codebase, or fork for your own deployment.

  • Lambda v8 โ€” Python 3.12
  • AWS CDK deployment scripts
  • Full DEPLOYMENT-CHECKLIST.md
View on GitHub โ†’
SDK Reference Full Documentation Connect API Wizard Platform Status Report an Issue