项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1201
使用教程
环境要求
- 一个已初始化的 shadcn-vue 项目(项目内存在 components.json)
- 可执行 npx 的 Node.js 环境
- 推荐开启 TypeScript 以获得更好的开发体验
- 推荐使用 shadcn-vue 的 CSS Variables 主题模式
安装与启动步骤
-
1确认项目配置
在 Vue 项目根目录确认已完成 shadcn-vue 配置并存在 components.json,组件会按该文件指定的目录安装。
-
2安装全部组件
一条命令装齐 AI Elements Vue 的全部组件,CLI 会自动配置 shadcn-vue、写入组件并补充依赖。
npx ai-elements-vue@latest -
3安装指定组件
用 add 子命令安装单个组件,组件名替换成你需要的名称,如 message、conversation。
npx ai-elements-vue@latest add message -
4一次装多个组件
add 后可跟多个组件名,用空格分隔,一次把多个组件装进项目。
npx ai-elements-vue@latest add message conversation -
5改用 registry 安装
如果习惯直接用 shadcn-vue CLI,也可以通过官方 registry 地址安装全部或单个组件。
npx shadcn-vue@latest add https://registry.ai-elements-vue.com/message.json -
6配置 AI Gateway
按推荐做法搭建 Vercel AI Gateway,并把 AI_GATEWAY_API_KEY 写入项目根目录的 .env.local。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
components.json | 是 | shadcn-vue 配置文件,决定组件安装到哪个目录 | ./components.json |
AI_GATEWAY_API_KEY | 否 | Vercel AI Gateway 密钥,用于接入 AI 能力,按推荐配置 | AI_GATEWAY_API_KEY=sk-xxxxxxxx |
如何确认成功
命令执行无报错,打开 components.json 中指定的组件目录,能看到刚安装的 AI Elements Vue 组件文件。
常见问题
Q:运行命令后组件装到了哪里?
A:安装位置由项目已有的 shadcn-vue 配置决定,即 components.json 里配置的组件目录。
Q:必须预先配置 shadcn-vue 吗?
A:推荐已有 shadcn-vue 配置。执行安装全部组件的命令时,若尚未配置,CLI 也会帮你完成 shadcn-vue 的初始化。
Q:不懂有哪些组件可以装怎么办?
A:README 中给出的示例组件名有 message 和 conversation,可先用这两个试装,其余名称请查阅官网文档。
Q:一定要配置 AI_GATEWAY_API_KEY 吗?
A:这是官方推荐做法,用于接入 Vercel AI Gateway。它属于推荐项,不写密钥同样可以先把组件安装到项目中。
注意事项
- 命令里的 <component-name>、<name1> 是占位符,执行前要替换成真实组件名。
- AI_GATEWAY_API_KEY 应写入 .env.local,不要提交到 Git 仓库。
- 推荐使用 shadcn-vue 的 CSS Variables 模式做主题定制,并启用 TypeScript。
核心亮点
- 基于 shadcn-vue,样式可定制且与现有项目风格统一
- 内置聊天、消息流等常用 AI 组件,减少重复造轮子
- 积极借鉴 Vercel AI 设计模式,交互体验现代
不足之处
- 项目仍处于早期,组件覆盖范围有限
- 文档和示例相对简略,上手需参考 shadcn-vue 文档
适用场景
- 快速搭建 AI 聊天机器人前端界面
- 在 Vue 项目中集成流式对话交互
- 构建 AI 工具链的管理面板,如提示词调试、会话管理
替代项目
shadcn-vue(基础组件库)、Vue Chat UI、nuxt-ai
上一篇:modelfusion
下一篇:poe-api-wrapper
同类项目推荐
eve
开源
用 TypeScript+Markdown 快速搭出可上线的 AI Agent
The Open Framework for Building Agents
whetstone.chatgpt
开源
用 .NET 轻松调用 OpenAI,几行代码接入 GPT 和 Whisper
A simple light-weight library that wraps the Open AI API.
ai-rulez
开源
一套规则,自动生成 19+ AI 工具配置,告别重复劳动
Author, generate, validate and govern AI agent rules, skills, plugins and MCP config···
UltraRAG
开源
低代码搭建复杂 RAG 流水线,快速落地智能检索应用
A Low-Code MCP Framework for Building Complex and Innovative RAG Pipelines
code-act
开源
让LLM用写代码的方式做决策,任务成功率更高
Official Repo for ICML 2024 paper "Executable Code Actions Elicit Better LLM Agents"···
wechaty
开源
给微信装个 AI 客服,消息秒回不冷场
Conversational RPA SDK for Chatbot Makers. Join our Discord: https://discord.gg/7q8N···
deepseek-laravel
开源
Laravel 项目一行代码接入 Deepseek 大模型,快速实现智能对话。
Laravel wrapper for Deepseek PHP client, to seamless deepseek API integration with l···
learn-harness-engineering
开源
从零上手 Harness 工程,快速构建生产级 AI Agent
Harness engineering beginner tutorial, from 0 to 1
flyte-sdk
开源
用 Python 异步语法,类型安全地编排 ML 流水线和智能体
Type-safe, distributed orchestration of agents, ML pipelines, and real-time inferenc···
