ZeroLeaks SDK
Installation
Install the ZeroLeaks SDK, configure a server-side API key, and add an optional provider integration.
Installation
bun add @zeroleaks/sdk
# or
npm install @zeroleaks/sdkAdd the provider package used by your application when you want a first-party adapter:
bun add ai # AI SDK adapter
bun add openai # OpenAI adapterBoth are optional peer dependencies. A custom runtime target does not require either package.
API key
Create a ZeroLeaks API key in dashboard settings and store it in a server-only environment variable:
ZEROLEAKS_API_KEY=zl_live_...import { ZeroLeaks } from "@zeroleaks/sdk";
const zeroleaks = new ZeroLeaks();You may pass configuration explicitly:
const zeroleaks = new ZeroLeaks({
apiKey: process.env.ZEROLEAKS_API_KEY,
baseUrl: "https://zeroleaks.ai",
timeoutMs: 30_000,
});Imports
import { ZeroLeaks, createRuntimeTarget } from "@zeroleaks/sdk";
import { aiSdk } from "@zeroleaks/sdk/ai-sdk";
import { openAI } from "@zeroleaks/sdk/openai";Provider integrations use separate entry points so applications that do not use them do not load their dependencies.
Security
Initialize the SDK only in trusted server, worker, test, or CI code. Never expose a zl_live_ key in browser JavaScript.