Anvia Docs

Use this path when Anvia runs inside an existing Express server or a new Node API.

1. Create An Express Project

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

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`	Express router for prompt and stream endpoints
`src/middleware/auth.ts`	Request auth and `req.user` enrichment
`src/app.ts`	Express app, JSON parser, routers, and error middleware

Build the reusable agent in Setup Anvia. Read Runtime Boundaries for where application code should own auth, storage, and side effects.