home-llm

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署 开源模型 🍴 复刻 157 🐛 待处理 45 👀 关注 20
GitHub ↗
GitHub 星标 ★ 1490
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目，本地部署，完全免费

项目预览

home-llm 项目界面预览图
图片来源：GitHub 官方仓库名片

项目数据

分类开源模型
开发团队acon96
GitHubhttps://github.com/acon96/home-llm
定价模式🏷️完全免费
价格说明开源项目，本地部署，完全免费
访问状态🔧 仅开源项目，无在线服务，需自行部署
是否开源是
主要语言Python
技术栈/模型homeassistant-custom-component,large-language-model
GitHub 星标★ 1490
上线时间2023-12-23 00:00:00
代码更新2026-11-07
仓库体积62.8 MB
本站数据更新2026-11-08
维护状态活跃
收录时间2026-08-09
浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1490

技术标签

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：进阶 约 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

上一篇：AgentsMeetRL

下一篇：muxi

同类项目推荐

acryl 开源

一份上下文，喂给所有编码智能体

ACRYL - Agent Context Relay Yielding Lifecycles. One persistent workspace, one canon···

★ 296 2026-10-24
atris 开源

让AI智能体自我进化，自动优化任务执行流程

Say what you want in plain words. Atris plans it, builds it, checks it, and shows pr···

★ 71 2026-08-09
octotools 开源

让大模型轻松调用工具，搞定复杂推理任务

OctoTools: An agentic framework with extensible tools for complex reasoning

★ 1498 2026-08-09
sayna 开源

给AI Agent装上语音嘴和耳，快速实现语音交互

Sayna is a unified Voice Layer for AI Agents with a seemless integration to an exist···

★ 317 2026-08-09
frankenterm 开源

统一管理多个 AI 编码代理的终端，实时监控并调度。

Swarm-native terminal platform for AI coding agents: real-time pane capture, change-···

★ 126 2026-08-09
heurist-agent-framework 开源

用 Python 快速搭出会推理、能调工具、可上链的智能体服务

A flexible multi-interface AI agent framework for building agents with reasoning, to···

★ 828 2026-09-13
gptme 开源

在终端里用自然语言指挥 AI 写代码、跑命令、查资料

Your agent in your terminal, equipped with local tools: writes code, uses the termin···

★ 4469 2026-08-09
Everywhere 开源

看屏懂你，跨应用自动干活

On-screen aware AI assistant for your desktop. Uses current app context, multiple LL···

★ 6350 2026-08-09
graphite 开源

用 Python 快速搭多步骤 AI 智能体

Graphite Agentic Framework by Binome Technologies

★ 180 2026-10-20