SDK · npm package · v0

Install.
Import. Ship.

A typed TypeScript / JavaScript client for the AIDRAN corpus. Auth, cursor pagination, and the live signal stream are handled for you; every response is fully typed against the data model. Works in Node and edge runtimes. Same Bearer key as the REST API.

View on npm ↗SDK reference →
$ npm i aidran

Node ≥ 18 · ESM & CJS · Tree-shakeable

Quickstart · TypeScript

Get an API key →
import { Aidran } from "aidran";
 
const aidran = new Aidran({ apiKey: process.env.AIDRAN_KEY });
 
// Cursor-paginated, filterable, typed end to end
const { items, nextCursor } = await aidran.records.list({
  source: "reddit",
  sentiment: "negative",
  limit: 100,
});
 
// Pull the latest stories with cited evidence
const stories = await aidran.stories.list({ limit: 10 });
 
// Subscribe to the live signal stream
for await (const signal of aidran.stream.signals()) {
  console.log(signal.kind, signal.sigmaScore);
}

What the SDK exposes

01

Records

The raw discourse layer — Reddit, Bluesky, HN, arXiv, YouTube, News, X. Filter by source, sentiment, entity, beat. Cursor-paginated.

aidran.records.list({ … })
02

Stories

Versioned editorial output with cited evidence. Lead, secondary, beat, dispatch — each typed by story kind and arc status.

aidran.stories.list({ … })
03

Signals

Novelty, velocity, and divergence detections from the corpus pipeline. Filter by sigma, beat, or time window.

aidran.signals.list({ … })
04

Live stream

Server-Sent Events over the same Bearer key. Heartbeats every 30 seconds; reconnect handling is in the client.

aidran.stream.signals()
Self-host · DockerForthcoming

Container images for the AIDRAN client — coming soon.

We are packaging the AIDRAN client and its read-side companions for Docker so teams can pin the corpus surface inside their own infra. The image is not yet published — this is what is on the bench, not what is shipped.

  • ARoadmap

    aidran/aidran (image)

    Run the corpus client locally

    A small image bundling the AIDRAN client and a thin CLI for ad-hoc corpus queries from CI, cron, or a workstation. Same Bearer auth as the REST API.

  • BRoadmap

    Your VPC

    AWS / GCP, in your account

    A reference compose / Helm chart for running the read surface against AIDRAN Cloud from inside your own network. Scoped per engagement today; productized as the Docker rollout progresses.

  • CRoadmap

    Air-gapped

    On-prem, offline updates

    For regulated environments. Longer timeline, scoped per contract. We will not pretend this ships today; we will scope it honestly with you.

Want it sooner?

VPC and air-gapped scopes are sized per contract. If your team needs the AIDRAN read surface inside your network, get in touch — connector and image priority is set by who's asking. Talk to the founder →

SDK reference

The full SDK reference catalogs every CLI command, namespace export, and subpath. Grounded in the public scaffold at github.com/AIDRAN/aidran. Looking for the REST API instead? API reference →

SDK reference →