TOM88812/xiaozhi-android-client
一个基于小智、xiaozhi-server的Android、IOS语音对话应用,支持实时语音交互和文字对话。现在是flutter版本，打通IOS、Android端。请同志们动动小手，点点小星星，予以鼓励。
- Stars
- 1.6K
- Forks
- 411
- Last push (UTC)
- Sep 18, 2026
- Project status
- Active
TOM88812 ↗
Technical topics
Dependencies used
Dependency list 31 items
- flutter
{"sdk":"flutter"} - cupertino_icons
^1.0.8 - provider
^6.1.1 - shared_preferences
^2.5.2 - device_info_plus
^10.1.2 - crypto
^3.0.3 - uuid
^4.5.1 - timeago
^3.6.1 - http
^1.2.0 - http_parser
^4.0.2 - web_socket_channel
^2.4.0 - intl
^0.19.0 - image_picker
^1.0.7 - fl_chart
^0.66.2 - opus_flutter
^3.0.3 - opus_dart
^3.0.1 - flutter_sound
^9.26.0 - permission_handler
^11.4.0 - path_provider
^2.1.5 - just_audio
^0.9.36 - audio_session
^0.1.18 - flutter_pcm_player
^0.0.1 - record
^5.2.1 - flutter_launcher_icons
^0.14.3 - flutter_displaymode
^0.6.0 - flutter_staggered_grid_view
^0.7.0 - flutter_slidable
^4.0.0 - flutter_blue_plus
^1.35.3 - audio_streamer
^4.1.1 - flutter_testDevelopment
{"sdk":"flutter"} - flutter_lintsDevelopment
^5.0.0
Rankings
Original README
English project snapshot. Visit GitHub for the latest content.
Expand / collapse project README
小智 AI 助手 · 全端客户端
Android · iOS · HarmonyOS · Web · Windows · macOS · Linux
基于小智AI的实时语音对话应用 · 支持实时语音交互与文字对话
Release License: Apache-2.0 Stars Download https://img.shields.io/badge/%E6%96%87%E6%A1%A3-Wiki-yellow?style=flat-square&logo=wikipedia
🎉 新版本已发布，敬请体验！ Flutter iOS 与 Android 回音消除已实现，
欢迎大家 PR。 Dify 支持发送图片交互，可添加多个小智智能体到聊天列表。 觉得项目对您有用的，可以赞赏一下 —— 您的每一次赞赏都是我前进的动力。
📌 版本导览
|
|
当前项目包含两条产品线，定位不同，可按场景选择：
-
🟦 V1 原生客户端 · 纯血安卓 + 纯血鸿蒙（商业版赠送）
面向 AI 终端 / AI 硬件 / 智能体方向，包含两个原生版本：纯血安卓版、纯血鸿蒙版。购买商业版即可获赠。 -
💼 V3 商业版 · 全功能跨平台客户端
基于 Flutter，覆盖 Android、iOS、HarmonyOS、Web、Windows、macOS、Linux，也适配鸿蒙，支持编译 HAP 包。主打 全功能、全平台，深度适配自研服务端。
🟦 V1 原生客户端 · 纯血安卓 + 纯血鸿蒙（商业版赠送）
推荐场景：AI 终端设备 · AI 硬件产品 · 智能体设备 · 折叠屏 / 副屏设备
购买商业版即可获赠 V1 原生客户端，包含两个原生版本：
- 纯血安卓版 — 基于 Android 原生开发，适配安卓手机、平板、折叠屏及各类安卓 AI 硬件。
- 纯血鸿蒙版 — 基于 HarmonyOS NEXT 原生开发，适配鸿蒙生态设备、折叠屏、副屏设备。
📱 原生体验
- ✅ 纯血安卓 + 纯血鸿蒙 — 两个版本均为原生开发，不做套壳，启动快、功耗低、体验顺滑
- ✅ 折叠屏适配 — 展开态 / 折叠态双布局自适应，展开大屏充分释放信息密度
- ✅ 副屏适配 — 副屏卡片与主屏联动，与折叠屏、双屏设备更搭配
- ✅ 商业版服务端适配 — 与 V3 共用同一套商业版服务端能力
🤖 AI 终端 / AI 硬件 / 智能体能力
- ✅ 实时语音交互 — 实时语音对话与文字对话，支持实时打断
- ✅ 多小智服务 — 支持添加多个小智服务，轻松实现每人多助手
- ✅ 硬件端互通 — 可与硬件端互通，记忆不串
- ✅ IoT 控制 — 支持调用设备功能，适合作为 AI 终端中控
- ✅ 智能体方向扩展 — 可结合小智后端能力，扩展为面向 AI 硬件的智能体入口
- ✅ 支持3D模型 — Live2D + 3D模型（非webview）双兼容
- ✅ AI驱动模型 — AI驱动3D模型能唱歌跳舞，及表达情绪，更加贴合数字生命
🧩 适合的 AI 硬件形态
- AI 桌面终端 / AI 音箱
- AI 学习机 / AI 陪伴设备
- 鸿蒙折叠屏手机 / 平板
- 带副屏的 AI 硬件设备
- 智能体中控屏 / 家庭 AI 终端
💼 V3 商业版 · 全功能跨平台客户端
推荐场景：全功能手机客户端 · 全平台覆盖 · 办公大屏 · 需要完整商业功能的场景
基于 Flutter 框架，一套代码覆盖 Android、iOS、HarmonyOS、Web、Windows、macOS、Linux，深度适配自研服务端。 V3 也适配鸿蒙，支持编译 HAP 包。
📱 平台与适配
- ✅ 全平台覆盖 — Android / iOS / HarmonyOS / Web / Windows / macOS / Linux
- ✅ 鸿蒙适配 — 支持编译 HAP 包，可运行于 HarmonyOS
- ✅ 回音消除 — Flutter iOS 与 Android 回音消除已实现
- ✅ 商业版服务端适配 — 深度适配自研服务端
🎨 交互体验
- ✅ 自适应主题 — 深色 / 浅色主题适配，跟随设备自动切换
- ✅ 创新性心情模式 — 支持实时打断模式
- ✅ 语音实时打断 — 小智说话期间可随意打断，说您想说无人能挡
- ✅ OpenAI 测速 — OpenAI 接口响应测速，服务快不快一眼可见
🧠 AI 能力
- ✅ AI 服务提供商 — 支持 OpenAI 等服务，手机上也能用大模型
- ✅ 思考模式 — 支持 OpenAI 思考模式
- ✅ OpenAI 接口联网搜索 — 支持 OpenAI 接口服务联网搜索
- ✅ HTML 代码预览 — 模型写简单 HTML 代码即可预览，手机也能 AI 编程
- ✅ MCP_Client — 支持 MCP 能力调用，接口数据都能 DIY
- ✅ 视频播放 — 支持播放模型返回的视频
- ✅ Live2D — 多模型切换，支持导入自己心爱的模型人物
🔗 连接与协议
- ✅ WS — 支持 WS 协议服务
- ✅ MQTT-UDP — 支持 MQTT 协议服务，长连接
- ✅ 多小智服务 — 添加多个小智服务，轻松实现每人多助手
- ✅ 打通硬件端 — 可与硬件端互通，记忆不串
- ✅ IoT — 支持调用手机功能、导航、听歌等
👤 账号与数据
- ✅ 用户信息 — 展示会员到期时间、对话数量、绑定设备数量、声纹数量、配额使用情况、最近活动设备
- ✅ 设备管理 — 手机端查看当前登录用户的所有设备、新增设备
- ✅ 角色管理 — 手机端管理当前角色、新建角色
- ✅ 声纹管理 — 手机端录制声纹，让您的 AI 更懂您
- ✅ 对话记录 — 支持展示最近的对话记录
- ✅ 记忆管理 — 支持展示记忆
- ✅ 预留页面 — 预留记账、待办、日记等页面 UI，可集成小智后端能力扩展
🖥 服务端 商业版功能
| 功能模块 | 状态 | 描述 |
|---|---|---|
| 首句响应 | ✅ | 唤醒词响应时间 < 1 秒，极速响应体验 |
| 平均响应速度 | ✅ | 平均对话响应时间 < 2 秒（公网 CDN 网络），本地内网极限 800ms 内 |
| MQTT 协议 | ✅ | 支持 MQTT 通信协议，长连接、服务端主动唤醒 |
| 音色克隆 | ✅ | 支持火山引擎音色克隆，实现个性化声音定制 |
| 声纹识别 | ✅ | 支持声纹识别功能，实现个性化语音助手 |
| 双向流式交互 | ✅ | 支持火山流式播放，实时语音输入和回复输出 |
| 用户端 | ✅ | 友好的用户端操作界面，原生卡片方式设备管理页面 |
| MCP 接入点 | ✅ | 基于角色的 MCP 工具接入点，扩展功能接入（同步虾哥服务） |
| MCP Hub 服务 | ✅ | SSE / HTTP MCP Hub，支持更多第三方服务集成 |
| ESP32 设备主题自定义 | ✅ | 支持在线配置 ESP32 设备的主题、表情包 |
| Function Call | ✅ | 工具调用，提升用户体验 |
| 长期记忆 | ✅ | 根据用户对话提取关键信息记录，智能记忆管理 |
| 监控面板 | ✅ | 监控日、周、月不同维度 Token、对话时长、设备活跃等数据 |
| OTA 固件升级 | ✅ | 固件上传，自动升级，远程设备管理 |
| 聊天数据可视化 | ✅ | 聊天频率统计图表等数据可视化功能，监控对话数据趋势 |
| 用户会员制 | ✅ | 支持按会员等级设置 Token 数，支持包月 / 年，在线支付（支付宝、微信、PayPal） |
📞 联系方式
| 渠道 | 信息 |
|---|---|
| tang@lhht.cc | |
| Tang_xs-xk | |
| 定制开发 | 支持提供定制化开发客户端，欢迎联系 WeChat |
服务端图形化部署工具
🌟 支持
您的每一个 Star ⭐ 或赞赏 💖，都是我们不断前进的动力 🛸