Use and adapt anan-ai-1

Use the documented interfaces and source layout for anan-ai-1. The sections below retain the README’s examples and configuration details.

Structure

Environment

1. Copy the template and fill values:

1cp .env.example .env.local

2. Run Convex and push env from .env.local:

1npx convex dev

3. For production, set variables in Convex Dashboard → Settings → Environment Variables.

Required for agent + web automation

• OPENROUTER_API_KEY (or MODEL_API_KEY)
• BROWSERBASE_API_KEY
• BROWSERBASE_PROJECT_ID

Optional

• SERPER_API_KEY — web search fallback

Deployment

• Convex: npm run deploy:convex (uses .env.production). Or deploy via GitHub Actions on push to main when convex/ changes; set CONVEX_DEPLOY_KEY in repo secrets.
• Web & Admin: Deploy via Vercel. Create separate projects with root directories web/ and admin/.
• Mobile: Build with EAS from mobile/. See mobile/README.md.

Commands in the root manifest

The captured package.json declares the following scripts. Run them from the directory containing that manifest.

Troubleshoot a local change

1. Reproduce the smallest example from the quick-start guide.
2. Compare required configuration and dependency versions with the README.
3. Check the linked issue tracker for the same error. Include the command, runtime version, and relevant error when reporting a problem; omit credentials.

Source and help

• GitHub repository
• Original README
• Issues and existing reports