Happy slice of mcp pizzaMCP.pizza

xiaozhi-android-client

MCP.Pizza Chef: TOM88812

xiaozhi-android-client is a Flutter-based cross-platform client supporting Android, iOS, Web, Windows, macOS, and Linux. It enables real-time voice and text interactions with AI models via WebSocket, integrating multiple AI services including xiaozhi-server, Dify, and OpenAI. The client supports voice echo cancellation and multi-agent chat, providing a seamless conversational AI experience across devices.

Use This MCP client To

Enable real-time voice conversations with AI on Android and iOS Support multi-platform AI chat with a single Flutter codebase Integrate multiple AI models for diverse conversational capabilities Deploy AI voice assistant apps on mobile and desktop platforms Use WebSocket for low-latency voice and text communication Add multiple AI agents to chat lists for varied interactions Implement voice echo cancellation for clearer audio Package and customize AI chat apps for web and PC

README

小智AI助手 Android IOS 客户端

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

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

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

功能特点

  • 跨平台支持：使用Flutter框架，一套代码支持多平台
  • 多AI模型支持：
    • 集成小智AI服务
    • 支持Dify
    • 支持OpenAI-图文消息-流式输出
    • 支持官方小智-一键添加设备注册
  • 丰富的交互方式：
    • 支持实时语音通话（持续对话）
    • 支持文字消息交互
    • 支持图片消息
    • 支持通话手动打断
    • 支持按住说话
    • 支持实时语音打断
    • 支持添加多个智能体
  • 多样化界面：
    • 深色/浅色主题适配
    • 轻度拟物化
    • 自适应UI布局
    • 精美动画效果
  • 系统功能：
    • 多种AI服务配置管理
    • 自动重连机制
    • 语音/文字会话混合历史
    • 安卓 AEC+NS 回音消除
    • iOS 回音消除
    • 支持Qwen3模型开关思考模式
    • 支持HTML代码预览

系统要求

  • Flutter: ^3.7.0
  • Dart: ^3.7.0
  • iOS: 12.0+
  • Android: API 21+ (Android 5.0+)
  • Web: 现代浏览器支持

安装与构建

  1. 克隆项目:
git clone https://github.com/TOM88812/xiaozhi-android-client.git
  1. 安装依赖:
flutter pub get
  1. 运行应用:
flutter run
  1. 构建发布版本:
# Android
flutter build apk --release

# iOS
flutter build ios --release

# Web
flutter build web --release
  1. 如果没有证书: 安卓无影响。 IOS、Mac可以按照无签名的方法打包，使用第三方工具侧载。 IOS编译完后，需要在设置-APP中打开网络权限

配置说明

小智服务配置

  • 支持配置多个小智服务地址
  • OTA URL设置
  • Token认证
  • 自定义MAC
  • wss地址自动获取

Dify API配置

  • 支持配置多个Dify服务
  • API密钥管理
  • 服务器URL配置

OpenAI 服务

  • 支持OpenAI接口
  • 支持自定义模型
  • 温度等配置

开发计划

  • 深色/浅色主题适配
  • 支持更多AI服务提供商
  • 增强语音识别准确性
  • 支持OTA自动注册设备
  • 支持语音实时打断
  • 支持Qwen3模型开关思考模式
  • 支持HTML代码预览
  • 集成MIot 控制米家设备
  • 支持TTS
  • 支持MCP_Client
  • 支持OpenAI接口联网搜索🔍

服务端图形化部署工具

微信交流群

🌟支持

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

赞助

Star History

Star History Chart

xiaozhi-android-client FAQ

How do I set up the xiaozhi-android-client for development?
Clone the repository, install Flutter, and run on supported platforms like Android or iOS; ensure WebSocket server access.
Can I add other AI models besides xiaozhi-server?
Yes, it supports integration with Dify, OpenAI, and other AI services for extended functionality.
Does the client support real-time voice interaction?
Yes, it supports real-time voice and text conversations using WebSocket communication.
Is the client limited to mobile platforms?
No, it supports multiple platforms including Web, Windows, macOS, and Linux via Flutter.
How is voice echo cancellation handled?
The client implements echo cancellation for iOS and Android to improve voice interaction quality.
Can I customize the UI or add features?
Yes, since it is open source and built with Flutter, you can customize UI and extend features.
What protocols does the client use for communication?
It uses WebSocket for low-latency, real-time voice and text data exchange.
Is there support for image-based interactions?
Yes, integration with Dify allows sending and receiving image interactions in chat.
How do I contribute to the project?
Contributions are welcome via pull requests on GitHub; check the repo for contribution guidelines.