This repository provides a comprehensive boilerplate for building AI-powered applications and autonomous agents. It targets developers seeking a rapid start with integrated authentication, a PostgreSQL database, AI chat functionality via OpenRouter, and a modern UI, significantly accelerating the development of sophisticated AI-driven products.

How It Works

The project leverages a modern stack including Next.js 15, React 19, and TypeScript. Data persistence is handled by Drizzle ORM with PostgreSQL. AI capabilities are integrated using the Vercel AI SDK, offering access to over 100 models via OpenRouter. The user interface is built with shadcn/ui components styled by Tailwind CSS, adopting a mobile-first design approach for broad accessibility.

Quick Start & Requirements

• Prerequisites: Node.js (v18.0+), Git, PostgreSQL (local or hosted).
• Automated Setup: Run npx create-agentic-app@latest my-app or npx create-agentic-app@latest . for current directory. The CLI handles file copying, dependency installation, and environment setup.
• Manual Setup: Clone the repository, install dependencies (npm install), configure .env with credentials (PostgreSQL, Google OAuth, OpenRouter API key), generate and run migrations (npm run db:generate, npm run db:migrate), then start the dev server (npm run dev).
• Resources: A YouTube tutorial is linked for a walkthrough.

Highlighted Details

• Authentication: Integrated Google OAuth via Better Auth.
• Database: Drizzle ORM with PostgreSQL for robust data management.
• AI Integration: Vercel AI SDK enables access to numerous AI models through OpenRouter.
• UI: Modern, responsive UI components from shadcn/ui powered by Tailwind CSS.
• Stack: Next.js 15, React 19, TypeScript, mobile-first design.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or roadmap are provided in the README.

Licensing & Compatibility

• License: MIT License.
• Compatibility: The MIT license is permissive, generally allowing for commercial use and integration into closed-source projects.

Limitations & Caveats

This is a boilerplate, requiring users to configure API keys for Google OAuth and OpenRouter, and potentially customize extensively for specific application needs. AI chat functionality is optional and depends on OpenRouter API key configuration.