产品简介
xiaozhi-webui 这是一个基于 Python 和 Vue3 实现的 Web 端小智 AI,允许用户通过文字和语音与小智对话,支持打断、自动配置和移动适配,适合学习交流和在没有硬件条件下体验 AI 对话功能。
核心功能
- 文字聊天功能
- 语音聊天功能(支持打断)
- 自动配置(如MAC地址、OTA版本)
- 语音对话反馈动效(波形和头像动画)
- 移动端适配
快速开始
- 克隆项目到本地并进入目录
- 安装前端依赖(pnpm install)
- 安装后端依赖(cd backend && uv sync)
- 启动服务(pnpm dev)
- 访问浏览器 http://localhost:5173 使用
界面预览


与其他方案对比
| 对比项 | 本工具 | 同类商业软件 | 在线服务 |
|---|---|---|---|
| 费用 | 开源免费 | 通常收费或含广告 | 可能有订阅或上传限制 |
| 隐私 | 本地运行,数据自持 | 依赖厂商政策 | 需上传数据到服务器 |
| 可定制性 | 源码开放,社区活跃 | 受限于官方功能 | 功能固定 |
适合谁用
- 学习 Python 和 Vue3 的开发者
- 想体验 AI 语音对话但无硬件的用户
- 前端开发者学习 Vue3 和 WebSocket 集成
下载与版本
当前最新版本为 master,发布于 。支持 Windows、macOS、Linux。
⚠️ 注意:本项目仅提供源代码下载,不包含可直接运行的安装包(exe/dmg/apk 等。下载后需要自行编译构建才能使用,适合有一定开发经验的用户。如果你不熟悉编译流程,建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用,请遵守相关法律法规。
- 请尊重内容创作者版权,勿将下载内容用于商业或非法传播。
- 项目源码地址:https://github.com/Yang-ZhiHang/xiaozhi-webui