judahpaul16/gpt-home

这是什么？

核心功能

• 01通过 LiteLLM 接入 100 多家大模型服务商，API Key 可在 .env 或网页界面中配置。
• 02支持闹钟、提醒、待办清单和 CalDAV 日历事件。
• 03通过 OpenWeatherMap 和 Open-Meteo 查询天气。
• 04可控制 Spotify 播放和飞利浦 Hue 灯光。
• 05使用 PostgreSQL 与 pgvector 保存持久化记忆。
• 06以 Docker Compose 服务运行，附带适用于树莓派等 Linux 设备的安装脚本。

适用场景

• 在树莓派上自建家用语音助手，替代商用智能音箱。
• 为 DIY 智能家居增加通过对话控制 Spotify 和飞利浦 Hue 灯光的能力。
• 研究结合大模型、语音输入与智能家居集成的语音助手流程。

快速上手

1. 1

   从 README 运行官方安装脚本(该脚本通过管道执行远程内容,请自行运行)

2. 2

   在 .env 文件中设置 LITELLM_API_KEY(或通过网页界面 gpt-home.local/settings 设置)

3. 3

   使用新密钥重启服务

   docker compose down && docker compose up -d
4. 4

   查看日志,确认助手正在运行

   docker compose logs -f

使用前须知

• !主要面向树莓派和 Linux 系统,需要扬声器和麦克风等音频硬件。
• !需要 LLM 服务商的 API 密钥,使用可能产生费用。
• !采用 GPL-3.0 许可证,这是一种 copyleft 许可证,衍生作品须开源。

收录于专题

标签

常见问题

gpt-home 是什么？

一款运行在树莓派上的自托管语音助手，借助 LiteLLM 和 LangGraph 把大模型对话接入智能家居。 GPT Home 是一个可以在树莓派或其他 Linux 设备上自行搭建的语音助手，定位为 Google Nest Hub、Amazon Alexa 等商用智能音箱的自托管替代方案。请求通过 LiteLLM 转发，底层模型可以是 LiteLLM 支持的 100 多家服务商之一，例如 OpenAI、Anthropic 和 Google，API Key 既能写入 .env 文件，也能在网页设置页中填写。

gpt-home 可以免费使用吗？用的什么许可证？

gpt-home 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

gpt-home 还在维护吗？

半年内有更新。gpt-home 最近一次提交是在 2026年9月13日。

gpt-home 适合用来做什么？

在树莓派上自建家用语音助手，替代商用智能音箱。 为 DIY 智能家居增加通过对话控制 Spotify 和飞利浦 Hue 灯光的能力。 研究结合大模型、语音输入与智能家居集成的语音助手流程。

gpt-home 怎么安装和运行？

从 README 运行官方安装脚本(该脚本通过管道执行远程内容,请自行运行) 在 .env 文件中设置 LITELLM_API_KEY(或通过网页界面 gpt-home.local/settings 设置) 使用新密钥重启服务: docker compose down && docker compose up -d 查看日志,确认助手正在运行: docker compose logs -f

在哪里获取 gpt-home？

源代码和安装说明在 GitHub 上：https://github.com/judahpaul16/gpt-home