ghcr.io/xiaochao99/miloco-backend:beta

小米 Miloco（个人分支）

[!NOTE] 个人分支说明 此分支是开发者积极维护的版本，致力于更快的功能迭代和错误修复。主要增强功能：全面支持 Home Assistant 集成、RTSP 摄像头支持以及 macOS (MPS) 加速。

[!NOTE] 个人分支说明 此分支是开发者积极维护的版本，致力于更快的功能迭代和错误修复。主要增强功能：全面支持 Home Assistant 集成、RTSP 摄像头支持以及 macOS (MPS) 加速。

小米本地 Copilot（Xiaomi Local Copilot）是一款面向智能家居的未来探索解决方案。它以小米家庭摄像头作为视觉信息来源，以自研 LLM 为核心，连接全屋所有 IoT 设备。基于 LLM 的开发范式，用户可以通过自然语言定义各种家庭需求和规则，实现更广泛、更具创造性的智能设备联动。

英文 | 简体中文

最新动态

• [2026-01] v0.15 版本发布：支持将 Home Assistant 设备作为自动化规则的触发器。
• [2025-12] v0.14 版本发布：新增对 Home Assistant (HA) 设备的全面支持。
• [2025-12] v0.13 版本发布：支持集成第三方 RTSP 摄像头。为小米摄像头提供 RTSP 服务能力。新增 AI 引擎的 macOS (MPS) 硬件加速支持。
• 支持集成第三方 RTSP 摄像头。
• 为小米摄像头提供 RTSP 服务能力。
• 新增 AI 引擎的 macOS (MPS) 硬件加速支持。
• [2025-11] 小米 Miloco 框架开源（官方）

技术博客

为帮助用户深入了解本项目的新功能，我创建了专门的专栏进行介绍：

👉 AI 技术专栏 - 小米 Miloco 博客

核心功能

• 全新交互范式：基于 LLM 的开发范式，可通过自然语言交互完成规则设置和复杂设备指令控制。

• 全新交互范式：基于 LLM 的开发范式，可通过自然语言交互完成规则设置和复杂设备指令控制。

• 端侧 LLM：将家庭场景任务拆分为规划和视觉理解两个阶段。提供小米自研端侧模型 Xiaomi MiMo-VL-Miloco-7B，实现端侧视频理解，保障家庭隐私安全。

• 端侧 LLM：将家庭场景任务拆分为规划和视觉理解两个阶段。提供小米自研端侧模型 Xiaomi MiMo-VL-Miloco-7B，实现端侧视频理解，保障家庭隐私安全。

• 视觉数据新应用：以摄像头数据流作为感知信息来源，通过 LLM 分析视觉数据中包含的各类家庭场景事件，响应用户查询。

• 视觉数据新应用：以摄像头数据流作为感知信息来源，通过 LLM 分析视觉数据中包含的各类家庭场景事件，响应用户查询。

• 小米家庭生态：对接小米家庭生态，支持米家设备和场景的检索与执行，支持为小爱通知发送自定义内容。

• 小米家庭生态：对接小米家庭生态，支持米家设备和场景的检索与执行，支持为小爱通知发送自定义内容。

快速开始

系统要求

• 硬件要求

CPU: x64 架构
显卡：NVIDIA 30 系列及以上，至少 8GB 显存（推荐 12GB 及以上）
存储：推荐 16GB 及以上可用空间（用于本地模型存储）

• 软件要求

操作系统：
- Linux：x64 架构，推荐 Ubuntu 22.04 及以上 LTS 版本
- Windows：x64 架构，推荐 Windows 10 及以上，需 WSL2 支持
- macOS：支持 Apple Silicon/Intel（通过 MPS/CPU 运行，Apple Silicon 性能最佳）
Docker：20.10 及以上版本，需支持 docker compose
NVIDIA 驱动：支持 CUDA 的 NVIDIA 驱动
NVIDIA Container Toolkit：用于 Docker GPU 支持

安装

[!NOTE] 请注意：请确保您的系统满足上述硬件和软件要求。Windows 系统需进入 WSL 环境。

[!NOTE] 请注意：请确保您的系统满足上述硬件和软件要求。Windows 系统需进入 WSL 环境。

通过 Docker 安装 通过命令行一键安装

bash -c "$(wget -qO- https://xiaomi-miloco.cnbj1.mi-fds.com/xiaomi-miloco/install.sh)"

或先下载源码，再执行一键安装脚本：

git clone https://github.com/XiaoMi/xiaomi-miloco.git

bash scripts/install.sh

有关详细安装步骤，请参考 Docker 部署文档。

源码安装 有关源码安装步骤，请参考开发指南。

使用文档

请参考使用文档。

贡献指南

请参考贡献指南。

许可证

有关许可证详情，请参见 LICENSE.md。

[!IMPORTANT] 重要声明：本项目仅限非商业用途。未经小米公司书面授权，不得将本项目用于开发应用程序、网络服务或其他形式的软件。

安全问题

如果您在本项目中发现潜在的安全问题，或认为可能发现了安全问题，请通过我们的漏洞报告***通知 Miloco 团队。请勿创建公开的 GitHub Issues。

联系我们

问题反馈

问题反馈请通过以下方式参与：

• 提交 GitHub Issue

技术讨论

• GitHub Discussions
• GitHub Discussions
• 项目交流群（微信、飞书）：
• 项目交流群（微信、飞书）：

加入我们

小米 Miloco 团队正在招聘。将您的简历发送至 ***，邮件将直接送达项目负责人。

xiaomi-miloco@xiaomi.com

致谢

感谢为 Miloco 辛勤付出的原团队成员：zhaoy、yangyongjie、xx、Changyu、yyk、junhui、郭兴宝、47、afei。

你们的热情和才华是 Miloco 不断创新和进步的根本动力。

特别感谢：

• llama.cpp 开源项目提供推理后端能力