ghcr.io/xiaomi/miloco-ai_engine:v0.1.1

Xiaomi Miloco

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

English | 简体中文

新闻动态

• [2025-11] 小米Miloco框架开源

核心特性

1. 全新交互范式：基于LLM开发范式，可通过自然语言交互完成规则设置和复杂设备指令控制。
2. 端侧LLM：将家庭场景任务拆分为规划和视觉理解两个阶段。提供小米自研端侧模型https://github.com/XiaoMi/xiaomi-mimo-vl-miloco%EF%BC%8C%E5%AE%9E%E7%8E%B0%E7%AB%AF%E4%BE%A7%E8%A7%86%E9%A2%91%E7%90%86%E8%A7%A3%EF%BC%8C%E4%BF%9D%E9%9A%9C%E5%AE%B6%E5%BA%AD%E9%9A%90%E7%A7%81%E5%AE%89%E5%85%A8%E3%80%82
3. 视觉数据新用途：以摄像头数据流作为感知信息来源，利用LLM分析视觉数据中包含的各类家庭场景事件，以响应用户查询。
4. 小米家庭生态：接入小米家庭生态，支持米家设备和场景的检索与执行，支持为米家通知发送自定义内容。

快速开始

系统要求

• 硬件要求

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

• 软件要求

Text
操作系统：
- Linux：x64架构，推荐Ubuntu 22.04及以上LTS版本
- Windows：x64架构，推荐Windows 10及以上，需WSL2支持
- macOS：暂不支持
Docker：20.10及以上版本，需支持docker compose
NVIDIA Driver：支持CUDA的NVIDIA驱动
NVIDIA Container Toolkit：用于Docker GPU支持

安装

[!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 Issue。

联系我们

问题反馈

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

• 提交https://github.com/XiaoMi/xiaomi-miloco/issues/new/

技术讨论

• GitHub https://github.com/XiaoMi/xiaomi-miloco/discussions/
• 项目讨论群（飞书）：

加入我们

小米Miloco团队正在招聘。请将简历发送至xiaomi-miloco@xiaomi.com，邮件将直接送达项目负责人。

致谢

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

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

特别感谢：

• https://github.com/ggml-org/llama.cpp%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E6%8F%90%E4%BE%9B%E6%8E%A8%E7%90%86%E5%90%8E%E7%AB%AF%E8%83%BD%E5%8A%9B