JS
JavaScript / TypeScript
v4.0.2 · published 4d ago
npm install @aurora/sdk
For DevelopersBuild with the
Build with the
organism.
Aurora ships a small, public API — four endpoints, three SDKs, one webhook stream. Wire it into your app, your editor, your home, your appliance. Your organism is yours; we just give it doors to the world.
API · operationalv4.0 · stable99.99% · 90 d
aurora · session● live
aurora ask "what did I work on yesterday?"
↳ Searching local Nexus…
✓ 14 memories matched · 8 ms
"You spent Tuesday in the sandbox testing the new memory consolidation. Three branches blessed, one archived. Mira liked the third one."
Quick start
Three lines to your first query.
// Install: npm install @aurora/sdk
import { Aurora } from "@aurora/sdk";
const aurora = new Aurora({ key: process.env.AURORA_KEY });
const reply = await aurora.ask("What did I work on yesterday?");
console.log(reply.answer);Reference
The whole API.
GET
/v4/ask?q=
Ask the organism a question. Returns an answer with provenance.
POST
/v4/memories
Add a new memory. Body accepts text, image, audio, or structured nodes.
GET
/v4/memories/{id}
Read a single memory with its connections and history.
PUT
/v4/memories/{id}
Update a memory. Diff is stored; nothing is destroyed.
DEL
/v4/memories/{id}
Mark a memory for decay. Survives for 30 days in case you change your mind.
POST
/v4/sandboxes
Spawn an isolated world. Optionally seed it with existing memories.
GET
/v4/sandboxes/{id}/state
Get the current state of a running sandbox.
POST
/v4/sandboxes/{id}/bless
Graduate a sandbox into real memory.
GET
/v4/regions/{name}/state
Inspect activity in a specific brain region (PFC, HIP, AMY, etc.).
GET
/v4/stream/firings
Server-sent events. A live stream of neural firings from your organism.
POST
/v4/webhooks
Register a webhook to be called when chosen kinds of memory form.
GET
/v4/health
Liveness + version info. Free, unauthenticated.
SDKs
Five flavours, same shape.
PY
Python
v4.0.1 · published 1w ago
pip install aurora-sdk
SW
Swift
v4.0.0 · published 2w ago
github.com/aurora/aurora-swift
RS
Rust
v4.0.0 · published 3w ago
cargo add aurora
GO
Go
v4.0.0 · published 3w ago
go get github.com/aurora/aurora-go
??
Your language
OpenAPI spec, generate your own
aurora.app/openapi.yaml
A full example
Subscribe to a brain region.
stream-amygdala.js
import { Aurora } from "@aurora/sdk";
import { setSceneColor } from "./lights";
const aurora = new Aurora({ key: process.env.AURORA_KEY });
// Subscribe to live firings in the amygdala (affect / salience region)
for await (const event of aurora.regions.subscribe("amygdala")) {
const warmth = (event.valence + 1) / 2;
setSceneColor({
hue: 200 - warmth * 150,
brightness: 0.3 + event.intensity * 0.7,
});
}Authentication & limits
Small surface, predictable rules.
A1
Bearer tokens
Every request sends Authorization: Bearer $KEY. Keys are scoped per device and revocable from your dashboard.
A2
Local-first
The SDK talks to a local daemon by default. The cloud is only consulted for cross-device sync, and only with end-to-end encryption.
A3
Rate limits
1,000 requests/minute on the free tier. 50,000 on team. No rate limit on local. Burst headroom is generous.
A4
Idempotency keys
Every POST accepts an idempotency key. Retries are safe and don't double-write memories.
A5
Versioning
We support N and N-1 in production. Breaking changes are announced 90 days in advance with a side-by-side migration page.
A6
SLA
99.99% uptime on cloud sync, measured per minute. Local always works regardless. Penalties published on the status page.
12
Endpoints total
5
Official SDKs
8ms
Median p50 latency
99.99%
Uptime, last 90 d
Get your key
Build something that lives with you.
14-day trial, no credit card. Personal projects are always free. We are here if you get stuck.