Skip to main content

​
Requirements

  • Node 20 or later (LTS). The SDK is tested against Node 20 and Node 22.
  • Or a modern browser with native ESM, top-level await, fetch, and AbortController. No polyfills are bundled.

​
Install the package

pnpm add @gaussia/sdk

​
Peer dependencies

@gaussia/sdk declares zod and ai as peer dependencies so they resolve to a single copy in your application. 
pnpm add zod    # required at runtime
pnpm add ai     # optional — only if you use @gaussia/sdk/adapters/ai-sdk
  • zod (^3) is required. Public types are derived from Zod schemas, and schema parsing runs at runtime.
  • ai (^5) is an optional peer. Install it only if you import @gaussia/sdk/adapters/ai-sdk. If you implement the LanguageModel contract yourself, you do not need ai.
Importing only @gaussia/sdk resolves a bundle containing zero bytes from the adapter subpath or the ai peer. You pay for an adapter only when you import it.

​
Provider package

The Vercel AI SDK adapter wraps a provider model. Install the provider you use alongside ai: 
pnpm add @ai-sdk/openai

​
Verify the install

import { Gaussia } from "@gaussia/sdk";

console.log(typeof Gaussia); // "function"

​
Next steps

Quickstart

Run a first evaluation against a small dataset.