小智AI助手 Android IOS 客户端

目前已经发布新版本，敬请体验！flutter IOS与安卓回音消除已实现，欢迎大家PR。 觉得项目对您有用的，可以赞赏一下，您的每一次赞赏都是我前进的动力。 Dify支持发送图片交互。可以添加多个小智智能体到聊天列表。

一个基于WebSocket的Android语音对话应用,支持实时语音交互和文字对话。 基于Flutter框架开发的小智AI助手，支持多平台（iOS、Android、Web、Windows、macOS、Linux）部署，提供实时语音交互和文字对话功能。

新版IOS、安卓端（可以自行打包WEB、PC版本) 观看demo视频点击跳转

V3 版本 商业版功能（深度适配自研服务端） 💼

功能模块	状态	描述
自适应主题	✅	深色/浅色主题适配/跟随设备切换主题
AI服务提供商	✅	支持Openai、MiniMax等服务，手机上也能用大模型
思考模式	✅	支持Openai思考模式
HTML代码预览	✅	模型写简单HTML代码进行预览，手机也能ai编程
MCP_Client	✅	支持MCP能力调用，接口数据都能DIY
OpenAI接口联网搜索	✅	支持Oenai 接口服务联网搜索
视频播放	✅	支持播放模型返回的视频
OpenAI 测速	✅	openai接口响应测速，服务快不快一眼见
Live2D	✅	多模型切换、支持导入自己心爱的模型人物
Iot	✅	支持调用手机功能、导航、听歌等
创新性心情模式	✅	支持实时打断模式
MQTT-UDP	✅	支持MQTT协议服务，长连接
WS	✅	支持ws协议服务
语音实时打断	✅	能在小智说话的期间随意打断，说您想说无人能挡
多小智服务	✅	添加多个小智服务，轻松实现每人多助手
打通硬件端	✅	可与硬件端互通，记忆不串
深度适配服务端	✅	适配商业版服务端
用户信息	✅	展示会员到期时间，对话数量、绑定设备数量、声纹数量、配额使用情况、最近活动设备
设备管理	✅	支持手机端查看当前登录用户的所有设备、新增设备
角色管理	✅	支持手机端管理您当前角色、新建角色
声纹管理	✅	支持手机端录制声纹，让您的AI更懂您
对话记录	✅	支持展示最近的对话记录
记忆管理	✅	支持展示记忆
预留页面	✅	预留记账、代办、日记等页面UI，可集成小智后端能力扩展，协同小智，打造了解您的助手

服务端 商业版功能 💼

功能模块	状态	描述
首句响应	✅	唤醒词响应时间 <1秒，极速响应体验
平均响应速度	✅	平均对话响应时间 <2秒（公网CDN网络）（本地内网极限800ms内），流畅对话体验
MQTT协议	✅	支持MQTT通信协议，长连接、服务端主动唤醒
音色克лон	✅	支持火山引擎音色克隆，实现个性化声音定制
声纹识别	✅	支持声纹识别功能，实现个性化语音助手
双向流式交互	✅	支持火山流式播放，实时语音输入和回复输出
用户端	✅	友好的用户端操作界面，原生卡片方式设备管理页面
MCP接入点	✅	基于角色的MCP工具接入点，扩展功能接入（同步虾哥服务）
MCP Hub服务	✅	SSE/HTTP MCP Hub支持更多第三方服务集成
ESP32 设备主题自定义	✅	支持在线配置esp32设备的主题、表情包
Function Call	✅	工具调用，提升用户体验
长期记忆	✅	根据用户对话，提取关键信息记录，智能记忆管理
监控面板	✅	监控日、周、月不同维度Token，对话时长，设备活跃等数据
OTA固件升级	✅	固件上传，自动升级，远程设备管理
聊天数据可视化	✅	聊天频率统计图表等数据可视化功能，监控对话数据趋势
用户会员制	✅	支持更具会员等级设置Token数，支持包月/年，在线支付（支付宝、微信、PayPal）

联系方式

• email

lhht0606@163.com

• wechat

Forever-Destin

支持提供定制化开发客户端可以联系WeChat

服务端图形化部署工具

• https://space.bilibili.com/298384872
• https://znhblog.com/

🌟支持

您的每一个start⭐或赞赏💖，都是我们不断前进的动力🛸。

Star History

小智 AI 助手 (xiaozhi-android-client) 快速上手指南

1. 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS 或 Linux
• Flutter SDK：建议安装最新稳定版 (Stable Channel)，用于跨平台编译 (Android/iOS/Web/PC)。
  • 国内开发者推荐使用清华大学或上海交通大学镜像源加速 Flutter 和 Dart 包下载。
• 开发工具：Android Studio (配置 Android SDK) 或 VS Code (安装 Flutter/Dart 插件)。
• 依赖管理：确保 git 已安装并配置好环境变量。

提示：如果您仅需使用成品应用，可直接前往 Releases 页面 下载已编译的 APK 或 IPA 文件，无需搭建开发环境。

2. 安装步骤

克隆项目

打开终端，执行以下命令获取源代码：

git clone https://github.com/TOM88812/xiaozhi-android-client.git
cd xiaozhi-android-client

获取依赖

进入项目目录后，运行以下命令拉取 Flutter 依赖包（国内网络建议使用代理或配置镜像）：

flutter pub get

构建与运行

连接您的 Android 设备或启动模拟器，然后运行：

flutter run

若需打包发布版本 (APK)：

flutter build apk --release

若需构建 iOS 版本 (仅限 macOS 环境)：

flutter build ios --release

3. 基本使用

本项目是一个基于 WebSocket/MQTT 协议的语音对话客户端，核心功能是与后端服务进行实时交互。

基础配置

1. 启动应用：在真机或模拟器上运行应用。
2. 服务连接：
   • 进入设置页面，配置后端服务地址 (支持 WS 或 MQTT-UDP 协议)。
   • 输入您的 API Key 或选择预设的 AI 服务提供商 (如 OpenAI, MiniMax 等)。
3. 多智能体管理：
   • 在聊天列表中添加多个“小智”智能体。
   • 支持为不同角色配置不同的音色、性格及 MCP 工具调用能力。

核心功能体验

• 语音交互：点击麦克风图标或直接说话（支持实时打断），即可与 AI 进行流畅的双向语音对话。
• 图文交互：支持发送图片给 Dify 等后端进行识别与分析。
• 高级特性：
  • 代码预览：当 AI 生成 HTML 代码时，可直接在手机端预览渲染效果。
  • 视频播放：支持播放模型返回的视频流。
  • IoT 控制：通过语音指令调用手机导航、音乐播放等功能。
  • 声纹识别：录制个人声纹，实现个性化的语音助手体验。

自定义开发

• UI 定制：项目采用 Flutter 开发，可轻松修改 lib 目录下的源码以适配深色/浅色主题或自定义 Live2D 模型。
• 后端对接：支持深度适配自研商业版服务端，包括长记忆管理、设备管理及用户配额监控等功能。