https://github.com/hugorcd/nuxt-ui-chat
Nuxt UI app using the aisdk v5: streaming AI chat, multi-model support, AI Gateway, and generative UI
https://github.com/hugorcd/nuxt-ui-chat
ai ai-gateway aisdk chat generative-ui nuxt-ui reasoning vercel
Last synced: 9 months ago
JSON representation
Nuxt UI app using the aisdk v5: streaming AI chat, multi-model support, AI Gateway, and generative UI
- Host: GitHub
- URL: https://github.com/hugorcd/nuxt-ui-chat
- Owner: HugoRCD
- Created: 2025-07-10T11:26:26.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-28T18:32:50.000Z (11 months ago)
- Last Synced: 2025-07-30T12:35:53.821Z (10 months ago)
- Topics: ai, ai-gateway, aisdk, chat, generative-ui, nuxt-ui, reasoning, vercel
- Language: Vue
- Homepage: https://nuxt-ui-chat.hrcd.fr
- Size: 24.3 MB
- Stars: 85
- Watchers: 2
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Nuxt UI Chat
A modern, full-featured AI chatbot application built with Nuxt 3, Nuxt UI Pro, and the Vercel AI SDK v5. Features real-time streaming, multiple AI models support via AI Gateway, persistent chat history with PostgreSQL, and a beautiful responsive interface.
## Features
- ⚡️ **Streaming AI responses** powered by [Vercel AI SDK v5](https://ai-sdk.dev)
- 🤖 **Multiple AI models** support via [Vercel AI Gateway](https://vercel.com/docs/ai-gateway) - access OpenAI, Anthropic, Google, and more
- 🧠 **Reasoning models** support for advanced problem-solving capabilities
- 🧩 **Generative UI** - AI can generate interactive components (e.g., weather widgets)
- 🔐 **GitHub authentication** via [nuxt-auth-utils](https://github.com/atinux/nuxt-auth-utils)
- 💾 **Persistent chat history** with PostgreSQL and [Drizzle ORM](https://orm.drizzle.team)
- 🎨 **Beautiful UI** built with [Nuxt UI Pro](https://ui.nuxt.com/pro) components
- ⚡ **Real-time syntax highlighting** with Shiki
- 📱 **Responsive design** optimized for all devices
- ⌨️ **Keyboard shortcuts** and command palette
- 🔍 **Chat search** and management
## Tech Stack
- **Frontend**: Nuxt, Nuxt UI Pro, TailwindCSS
- **AI**: Vercel AI SDK v5, Vercel AI Gateway
- **Database**: PostgreSQL with Drizzle ORM
- **Authentication**: GitHub OAuth via nuxt-auth-utils
- **Deployment**: Vercel (recommended)
## Quick Start
```bash
git clone
cd nuxt-ui-chat
pnpm install
```
## Setup
### Environment Variables
Create a `.env` file with the following variables:
```env
# GitHub OAuth (create at https://github.com/settings/applications/new)
NUXT_OAUTH_GITHUB_CLIENT_ID=
NUXT_OAUTH_GITHUB_CLIENT_SECRET=
# Database (recommended: Neon PostgreSQL)
DATABASE_URL=
# Vercel AI Gateway (optional but recommended for analytics and caching)
AI_GATEWAY_API_KEY=
# Nuxt UI Pro License (required for production)
NUXT_UI_PRO_LICENSE=
```
### Database Setup
We recommend using [Neon](https://neon.tech) for PostgreSQL hosting, especially with Vercel's integration:
1. Create a Neon account and database
2. Copy the connection string to `DATABASE_URL`
3. Run database migrations:
```bash
pnpm db:generate
pnpm db:migrate
```
### AI Gateway Setup (Optional)
For better analytics, caching, and cost optimization:
1. Create a [Vercel AI Gateway](https://ai-sdk.dev/docs/ai-gateway)
2. Add the API key to `AI_GATEWAY_API_KEY`
## Development
Start the development server:
```bash
pnpm dev
```
The app will be available at `http://localhost:3000`
## Production
Build for production:
```bash
pnpm build
```
Preview production build locally:
```bash
pnpm preview
```
## Deployment
### Vercel (Recommended)
1. Connect your repository to Vercel
2. Configure environment variables in Vercel dashboard
3. Ensure Neon integration is set up for the database
4. Deploy!
### Other Platforms
This app can be deployed on any platform that supports Node.js and PostgreSQL:
- Railway
- DigitalOcean App Platform
- Self-hosted with Docker
## Database Commands
```bash
# Generate new migration after schema changes
pnpm db:generate
# Apply migrations to database
pnpm db:migrate
# Type checking
pnpm typecheck
# Linting
pnpm lint
```
TODO:
- [x] Basic rate limit
- [ ] Better rate limit handling
- [x] Better rate limit handling in the UI (display)
- [ ] Web search with sources display
- [ ] Abort streaming
- [ ] Resume streaming on page reload
- [ ] Image generation
- [ ] Add image to message
- [ ] Change model during conversation
## License
This project requires a [Nuxt UI Pro license](https://ui.nuxt.com/pro) for production use.
## Contributing
Feel free to contribute by opening issues or submitting pull requests!