Nuxt AI Chatbot Template

Full-featured AI Chatbot Nuxt application with authentication, chat history, multiple pages, collapsible sidebar, keyboard shortcuts, light & dark mode, command palette and more. Built using Nuxt UI components and integrated with AI SDK v5 for a complete chat experience.

• Live demo
• Documentation

Features

• ⚡️ Streaming AI messages powered by the AI SDK v5
• 🤖 Multiple model support via various AI providers with built-in AI Gateway support
• 🔐 Authentication via nuxt-auth-utils
• 💾 Chat history persistence using PostgreSQL database and Drizzle ORM
• 🚀 Easy deploy to Vercel with zero configuration

Quick Start

1
npm create nuxt@latest -- -t ui/chat

Deploy your own

Setup

Make sure to install the dependencies:

1
pnpm install

Set up your environment variables by creating a .env file:

1
# Database
2
DATABASE_URL=<your-postgresql-database-url>
3

4
# GitHub OAuth (optional, for authentication)
5
NUXT_OAUTH_GITHUB_CLIENT_ID=<your-github-oauth-app-client-id>
6
NUXT_OAUTH_GITHUB_CLIENT_SECRET=<your-github-oauth-app-client-secret>
7

8
# AI Configuration via Vercel AI Gateway (unified API for all providers)
9
AI_GATEWAY_API_KEY=<your-vercel-ai-gateway-api-key>
10

11
# Password for nuxt-auth-utils (minimum 32 characters)
12
NUXT_SESSION_PASSWORD=<your-password>

[!TIP] With Vercel AI Gateway, you don't need individual API keys for OpenAI, Anthropic, etc. The AI Gateway provides a unified API to access hundreds of models through a single endpoint with automatic load balancing, fallbacks, and spend monitoring.

To add authentication with GitHub, you need to create a GitHub OAuth application.

Run database migrations:

1
pnpm db:migrate

Development

Start the development server on http://localhost:3000:

1
pnpm dev

Production

Build the application for production:

1
pnpm build

Locally preview production build:

1
pnpm preview

Deploy to Vercel:

1
npx vercel

Or connect your repository to Vercel for automatic deployments:

1. Push your code to GitHub
2. Connect your repository to Vercel
3. Configure your environment variables in the Vercel dashboard
4. Deploy automatically on every push

[!NOTE] Make sure to configure your PostgreSQL database connection and run migrations in your production environment.

The application is configured to use Vercel AI Gateway which provides:

• Unified API: Access hundreds of AI models through a single endpoint
• High Reliability: Automatic retries and fallbacks between providers
• Spend Monitoring: Track usage and set budgets across all providers
• Load Balancing: Distribute requests for optimal performance

Simply configure your AI_GATEWAY_API_KEY in your Vercel environment variables for production use.

AI Gateway Setup

1. Create a Vercel account at vercel.com
2. Navigate to your AI Gateway settings
3. Generate an API key for your project
4. Add the key to your environment variables as AI_GATEWAY_API_KEY

The AI Gateway automatically handles authentication with all supported AI providers including OpenAI, Anthropic, Google, xAI, and many others.

Renovate integration

Install Renovate GitHub app on your repository and you are good to go.