@substructure.ai/runtime

The in-process runtime for Substructure, a durable runtime for AI agents. NAPI bindings to the Rust core.

Use this if you want to run the agent runtime embedded in your Node.js process instead of running a separate server. For the standalone server, use @substructure.ai/cli.

Install

npm i @substructure.ai/runtime

This pulls a platform-specific native binding for your OS and architecture.

Supported platforms: macOS (arm64, x64), Linux (arm64, x64).

Usage

Typically used through @substructure.ai/sdk:

import { Substructure } from "@substructure.ai/sdk";
import { EmbeddedRuntime } from "@substructure.ai/runtime";

const runtime = new EmbeddedRuntime({ db: "agent.db" });
const sub = new Substructure({ runtime });

See the main repository for full documentation and examples.

License

FSL-1.1-ALv2. Converts to Apache 2.0 two years after each release.