Anvia Docs

Use this path when Anvia runs inside a Fastify API or plugin-based Node service.

1. Create A Fastify Project

mkdir anvia-fastify
cd anvia-fastify
pnpm init
pnpm add fastify fastify-plugin zod
pnpm add -D tsx typescript @types/node

pnpm add @anvia/core @anvia/openai

Install other provider packages when needed:

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

OPENAI_API_KEY=sk_...

Read the value in server code:

const apiKey = process.env.OPENAI_API_KEY;

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

File	Purpose
`src/ai/support-agent.ts`	Provider client, model, tools, and reusable agent
`src/routes/support.ts`	Fastify plugin with prompt and stream routes
`src/plugins/auth.ts`	Auth decoration and hooks
`src/app.ts`	Fastify instance and plugin registration

Build the reusable agent in Setup Anvia. Read Runtime Boundaries for the SDK and application boundaries.