Source: https://ai-sdk.dev/elements

Vercel

Slash Forward

Sparkles

AI SDK

Docs Cookbook Providers Playground AI ElementsAI ElementsLeft sparkleRight sparkle AI GatewayGateway

Search...⌘KFeedback GitHub Vercel LogoSign in with Vercel

Introduction

What is AI Elements and why you should use it.

AI Elements is a component library and custom registry built on top of shadcn/ui to help you build AI-native applications faster. It provides pre-built components like conversations, messages and more.

Installing AI Elements is straightforward and can be done in a couple of ways. You can use the dedicated CLI command for the fastest setup, or integrate via the standard shadcn/ui CLI if you've already adopted shadcn's workflow.

AI Elements

shadcn CLI

npx ai-elements@latest

Quick Start

---

Here are some basic examples of what you can achieve using components from AI Elements.

ChatGPT

Claude

Grok

AttachSearch

Voice

Analyze dataSurprise meSummarize textCodeGet adviceMore

Prerequisites

---

Before installing AI Elements, make sure your environment meets the following requirements:

• Node.js , version 18 or later
• A Next.js project with the AI SDK installed.
• shadcn/ui installed in your project. If you don't have it installed, running any install command will automatically install it for you.
• We also highly recommend using the AI Gateway and adding AI_GATEWAY_API_KEY to your env.local so you don't have to use an API key from every provider. AI Gateway also gives $5 in usage per month so you can experiment with models. You can obtain an API key here .

AI Elements is built targeting React 19 (no forwardRef usage) and Tailwind CSS 4.

Installing Components

---

You can install AI Elements components using either the AI Elements CLI or the shadcn/ui CLI. Both achieve the same result: adding the selected component’s code and any needed dependencies to your project.

The CLI will download the component’s code and integrate it into your project’s directory (usually under your components folder). By default, AI Elements components are added to the @/components/ai-elements/ directory (or whatever folder you’ve configured in your shadcn components settings).

After running the command, you should see a confirmation in your terminal that the files were added. You can then proceed to use the component in your code.

Usage

Learn how to use AI Elements components in your application.

On this page

Quick Start Prerequisites Installing Components

GitHubEdit this page on GitHub Scroll to topCopy pageOpen in chat