> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gaussia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install @gaussia/sdk and its peer dependencies for Node or the browser.

## 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

<CodeGroup>
  ```bash pnpm theme={null}
  pnpm add @gaussia/sdk
  ```

  ```bash npm theme={null}
  npm install @gaussia/sdk
  ```

  ```bash yarn theme={null}
  yarn add @gaussia/sdk
  ```
</CodeGroup>

## Peer dependencies

`@gaussia/sdk` declares `zod` and `ai` as peer dependencies so they resolve to a single copy in your application.

```bash theme={null}
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`.

<Note>
  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.
</Note>

## Provider package

The Vercel AI SDK adapter wraps a provider model. Install the provider you use alongside `ai`:

```bash theme={null}
pnpm add @ai-sdk/openai
```

## Verify the install

```ts theme={null}
import { Gaussia } from "@gaussia/sdk";

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

## Next steps

<Card title="Quickstart" icon="play" href="/quickstart">
  Run a first evaluation against a small dataset.
</Card>
