Anvia Docs

Use this path when Anvia will run behind Next.js App Router route handlers.

1. Create or Open an App Router Project

pnpm create next-app@latest anvia-next --ts --app
cd anvia-next

If you already have a Next.js app, use the App Router app/ directory. The route examples in this guide use app/api/.../route.ts.

pnpm add @anvia/core @anvia/openai zod

Install other provider packages when you need them:

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

Anvia clients use explicit constructor options and do not read environment variables by themselves.

OPENAI_API_KEY=sk_...

Read the value only in server-side files:

const apiKey = process.env.OPENAI_API_KEY;

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

Keep these files server-only:

File	Purpose
`app/ai/support-agent.ts`	Provider client, model, tools, and reusable agent
`app/api/support/route.ts`	Non-streaming prompt endpoint
`app/api/support/stream/route.ts`	Streaming prompt endpoint

Next.js route handlers use the Web Request and Response APIs, so Anvia readableStream() can be returned directly.

Build the reusable agent in Setup Anvia. For the SDK model, read How Anvia Works.