gpt-home

树莓派自建语音管家，本地控家电更私密

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署自动化工作流 🍴 复刻 68 👀 关注 14

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 652

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源免费，需自备硬件与API密钥

项目预览

项目数据

分类自动化工作流

开发团队judahpaul16

官网地址https://hub.docker.com/r/judahpaul/gpt-home

GitHubhttps://github.com/judahpaul16/gpt-home

定价模式🏷️完全免费

价格说明开源免费，需自备硬件与API密钥

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议GPL-3.0

主要语言Python

技术栈/模型ai,automation,docker,fastapi,home-assistant,home-automation,iot,langchain,langgraph,langmem,llm,nginx,nodejs,openai,python,raspberry-pi,react,speech-recognition,spotify,typescript

GitHub 星标★ 652

上线时间2023-09-05 00:00:00

代码更新2026-09-13

仓库体积50.6 MB

本站数据更新2026-11-03

维护状态维护中

收录时间2026-09-16

浏览次数1

项目介绍

gpt-home 是一个运行在树莓派上的开源智能家居语音助手，目标是替代 Alexa、Google Home 等商业方案。它用 LiteLLM 统一接入多种大模型，用 LangGraph 编排对话与工具调用流程，并通过 FastAPI 提供本地服务，可对接 Home Assistant 控制灯光、开关等设备。项目自带 Docker 与 Nginx 部署配置，强调数据留在本地、可自定义唤醒词和对话逻辑，避免商业助手的隐私与订阅限制。核心能力包括多轮对话、意图识别、设备控制、可插拔的 LLM 后端，以及基于 LangMem 的长期记忆，让助手记住用户习惯。适合喜欢折腾、重视隐私、已有 Home Assistant 环境的用户，用一块树莓派和少量配置就能搭出可离线优先的私人语音管家。

Star 增长趋势

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

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

技术标签

ai automation docker fastapi home-assistant

使用教程

难度：进阶约 60 分钟部署方式：Docker部署 5 步

环境要求

树莓派 4 以上
Docker 与 compose
模型与语音服务密钥

安装与启动步骤

1树莓派装 Docker

整套服务跑在容器里，先把 Docker 和 compose 装好。
2拉代码配环境变量

模型密钥、语音服务凭据都在 .env 里，缺一个容器就会反复重启。
```
git clone https://github.com/judahpaul16/gpt-home.git
```
3起全套服务

第一次起会拉镜像，时间较长，建议加 -d 后台跑。
```
docker compose up -d
```
4盯启动日志

它是多容器编排，第一次启动最容易出问题，跟日志能快速定位。
```
docker compose logs -f
```
5浏览器访问验证

起来后打开本地地址，先测语音唤醒再测上下文记忆。