home-llm

用本地大模型自然语言控制智能家居,隐私安全不依赖云端。

home-llm 是一个专为 Home Assistant 设计的自定义集成组件,旨在通过本地大语言模型(LLM)实现对智能家居的自然语言控制。它解决了云端语音助手依赖网络、隐私泄露风险高以及无法深度定制家居自动化的问题。该项目的核心能力包括:将 Home Assistant 的设备、实体和自动化能力以工具调用的形式暴露给本地 LLM,支持多种主流模型(如 Llama、Mistral 等),并通过精心设计的提示词和上下文管理,让模型能够理解用户的自然语言指令并执行相应操作,如开关灯、调节温度、查询传感器数据等。此外,它还提供了对话式交互界面,方便用户通过聊天方式管理家居,同时支持自定义模型配置和权限控制,确保本地运行的安全性和隐私性。

开源 free 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1442
维护状态 活跃
是否开源
定价模式 free

项目数据

分类开源模型
开发团队acon96
所属国家
官网地址
定价模式free
价格说明开源项目,本地部署,完全免费
访问状态
是否开源
开源协议
主要语言Python
技术栈/模型homeassistant-custom-component,large-language-model
GitHub 星标★ 1442
30天Star增速
HF 下载量
上线时间2023-12-23 00:00:00
最近更新2026-09-23 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数4

使用教程

难度:进阶 约 15 分钟 部署方式:本地安装 3 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Home Assistant 2026.5.0 或更高版本
  • 一台可运行 Home Assistant 的主机(树莓派等低功耗设备亦可,无需 GPU)
  • 一个本地大语言模型,或可连接的外部模型服务商(可选)

安装与启动步骤

  1. 1确认 HA 版本

    先检查你的 Home Assistant 版本,必须为 2026.5.0 或更新版本,否则无法使用该集成组件。

  2. 2获取项目代码

    从 GitHub 仓库拉取 home-llm 源码到本地,后续步骤依据仓库内文档进行安装配置。

    git clone https://github.com/acon96/home-llm.git
  3. 3阅读官方安装指南

    README 明确要求按 docs/Setup.md 的详细说明安装,请打开该文档并逐步照做,不要跳过。

如何确认成功

README 未给出具体验证方式;安装后在 Home Assistant 的集成页面查看 Local LLM Integration 是否已加载。

常见问题

Q:必须联网或购买订阅才能用吗?

A:不需要。项目为完全本地运行方案,无需云服务和订阅,数据默认不离开你自己的设备。

Q:需要独立显卡吗?

A:不需要。README 说明模型可在树莓派等低功耗设备上运行,无需 GPU。

Q:支持哪些语言?

A:内置支持英语、德语、法语、西班牙语和波兰语,官方欢迎贡献更好的翻译。

Q:可以接入外部模型服务吗?

A:可以。后端方式灵活,既能作为 Home Assistant 的一部分本地运行模型,也能连接外部模型提供方。

Q:具体安装命令在哪里?

A:README 未直接给出命令,统一指向 docs/Setup.md,请以该安装指南为准。

注意事项

  • README 节选未提供具体安装命令,实际安装步骤请以仓库内 docs/Setup.md 为准。
  • 安装前务必确认 Home Assistant 版本不低于 2026.5.0。
  • 项目由 Home Assistant 自定义组件与配套的 Home Models 模型两部分组成,必要时两者都要部署。

核心亮点

  • 完全本地推理,数据不出门,隐私安全有保障
  • 无缝集成 Home Assistant,安装配置简单,支持自定义实体和自动化
  • 支持多种主流本地 LLM,灵活适配不同硬件性能

不足之处

  • 对硬件性能要求较高,低配置设备运行大模型可能卡顿
  • 依赖模型推理准确性,复杂指令可能理解偏差
  • 文档/社区待观察

适用场景

  • 家庭用户希望用自然语言控制灯光、空调等设备,且注重隐私
  • 开发者或极客在树莓派或NAS上搭建本地智能家居中枢
  • 需要离线运行、断网环境下仍可操作的智能家居场景

替代项目

Home Assistant Cloud、Wyoming (Rhasspy)、OpenHome

项目介绍

home-llm 是智能体领域的开源项目,由 acon96 开发,2023 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(1,442)位列前 30%,在智能体分类中处于中上游。

近 45 天,它的 GitHub 星标从 1,410 增加到 1,442,净增 32。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-23。本地部署,完全免费。

它主要面向的使用场景是:家庭用户希望用自然语言控制灯光、空调等设备,且注重隐私。同类可对比的替代方案包括 Home Assistant Cloud、Wyoming (Rhasspy)、OpenHome。

上一篇:AgentsMeetRL

下一篇:muxi

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 195 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12