Install and configure anan-ai

Follow the source instructions for anan-ai. Read the prerequisites and configuration steps before running an example.

Quick Start

Install

1pnpm install

Run Locally

1pnpm dev         # Convex backend
2pnpm dev:web     # apps/web on http://localhost:3000
3pnpm dev:admin   # apps/admin on http://localhost:3001
4pnpm dev:all     # Convex + web + admin

Build And Test

1pnpm typecheck
2pnpm test:once
3pnpm build

Deeper verification:

1pnpm test:deep:fast
2pnpm test:deep:surfaces
3pnpm test:deep:e2e
4pnpm test:deep:build
5pnpm test:deep
6pnpm test:deep:exhaustive

Environment Direction

Use local env files only for local development. Do not commit .env, .env.local, .env.*.local, .next/, node_modules/, or build/cache output.

Common Anan environment areas:

Convex deployment and site URLs
Better Auth secrets and trusted origins
Anan web/admin URLs
OAuth redirect origins
ANAN_APP_REGISTRATION_SYNC_TOKEN for trusted external app mirror sync

Check apps/web/README.md, apps/admin/README.md, and .env.example for app-specific setup.

Check the installation

After setup, continue with the first example. If a command fails, compare the runtime version, working directory, and required configuration with the original README before changing dependencies.

Source and help