Anvia Docs

Use this path when Anvia runs behind SvelteKit endpoints, form actions, or server-only modules.

1. Create A SvelteKit Project

pnpm create svelte@latest anvia-sveltekit
cd anvia-sveltekit
pnpm install

Choose TypeScript. Anvia code belongs in server-only files, not client components.

pnpm add @anvia/core @anvia/openai zod

Install other providers when needed:

pnpm add @anvia/anthropic @anvia/gemini @anvia/mistral

OPENAI_API_KEY=sk_...

Read secrets from $env/static/private inside server modules:

import { OPENAI_API_KEY } from "$env/static/private";

if (!OPENAI_API_KEY) {
  throw new Error("OPENAI_API_KEY is required");
}

File	Purpose
`src/lib/server/ai/support-agent.ts`	Provider client, model, tools, and reusable agent
`src/routes/api/support/+server.ts`	JSON endpoint
`src/routes/api/support/stream/+server.ts`	NDJSON stream endpoint
`src/hooks.server.ts`	Auth and request-local `locals`

Build the reusable agent in Setup Anvia. Read Runtime Boundaries before importing Anvia into Svelte components.