gpt-home is a free, open source automation project written in Python and released under GPL-3.0. It has 649 GitHub stars, 68 forks and 0 open issues, and was last pushed 4 days ago. On this registry it ranks #77 of 96 tracked projects in Automation, with 5 head-to-head comparisons available.

🏠 GPT Home 🤖💬

ChatGPT at home! Basically a better Google Nest Hub or Amazon Alexa home assistant. Built on the Raspberry P iusing LiteLLM and LangGraph.

This guide will explain how to build your own. It's pretty straight forward. You can also use this as a reference for building other projects on the Raspberry Pi.

• Theoretically, the app should run on any linux system thanks to docker, but I can only vouch for the versions listed in the compatibility table. You should be able use any plug-and-play USB/3.5mm speaker or microphone as long as it's supported by ALSA or PortAudio.

📦 Integrations ✅ OpenAI ✅ Spotify ✅ Philips Hue ✅ OpenWeatherMap ✅ Open-Meteo ✅ Alarms ✅ Reminders ✅ Calendar (CalDAV) ✅ LiteLLM ✅ LangGraph ✅ Persistent Memory ✅ Display Support 🔲 Zigbee2MQTT

🔧 Use Cases ☁️ Weather ⏰ Alarms ⌚ Reminders 📆 Calendar ☑️ To-Do List 📚 General Knowledge 🗣️ Translation 🎵 Music 💡 Lights 😆 Fun & Games

📖 Developer Documentation: For in-depth technical documentation, architecture details, and API references, visit the GPT Home Wiki.

🚀 TL;DR

Production (Raspberry Pi)

1. Run the setup script:

curl -s https://raw.githubusercontent.com/judahpaul16/gpt-home/main/contrib/setup.sh | \
    bash -s -- --no-build

2. Required: Set your API key. Copy the example config and add your key. GPT Home uses LiteLLM which supports 100+ providers (OpenAI, Anthropic, Google, Cohere, etc.):

cd ~/gpt-home
cp .env.example .env
sed -i 's/^LITELLM_API_KEY=$/LITELLM_API_KEY=your-api-key-here/' .env
docker compose down && docker compose up -d

Tip: You can also set the API key via the web interface at gpt-home.local/settings. See LiteLLM docs for all supported providers.

3. Optional: To view the logs and verify the assistant is running:

docker compose logs -f

Development (Any Machine)

git clone https://github.com/judahpaul16/gpt-home.git
cd gpt-home
cp .env.example .env
# Edit .env with your API keys
nano .env
# Start dev environment with hot reload
COMPOSE_PROFILES=dev docker compose up
# or
docker compose --profile dev up

Access at http://localhost (nginx routes to frontend and API).

🔌 Schematics

⚠️ Caution: Battery Connection

IMPORTANT: The image on the left is for illustration purposes. Do not connect the battery directly to the Raspberry Pi. Use a UPS or power supply with a battery like this one. Connecting the battery directly to the Raspberry Pi can cause damage to the board from voltage fluctuations.

Before connecting the battery, ensure that the polarity is correct to avoid damage to your Raspberry Pi or other components. Disconnect power sources before making changes.

📋 Specifications

All system dependencies (Docker, time sync, etc.) are installed automatically by the setup script.

🛠 My Parts List

This is the list of parts I used to build my first GPT Home. You can use this as a reference for building your own. I've also included optional parts that you can add to enhance your setup. To be clear you can use any system that runs Linux.

📶 Configuring Wi-Fi

If your Pi isn't connected via Ethernet, use the included Wi-Fi setup script. It configures wpa_supplicant + systemd-networkd, disables NetworkManager (which can interfere), sets up DNS, and disables Wi-Fi power saving:

curl -s https://raw.githubusercontent.com/judahpaul16/gpt-home/main/contrib/wifi-setup.sh | \
    sudo WIFI_SSID="your-ssid" WIFI_PSK="your-password" bash

Or run it interactively (prompts for SSID and password):

curl -s https://raw.githubusercontent.com/judahpaul16/gpt-home/main/contrib/wifi-setup.sh | \
    sudo bash

You can also set WIFI_IFACE (default: wlan0) and WIFI_COUNTRY (default: US) if needed.

sudo nmcli dev wifi connect "your-ssid" password "your-password"

sudo raspi-config

🐳 Building the Docker Container

Note: GPT Home uses LiteLLM which supports 100+ LLM providers. Set your LITELLM_API_KEY in the .env file or via the web interface at gpt-home.local/settings. See the LiteLLM docs for supported providers.

Optional: Add these aliases to your .bashrc file for easier management.

## Set working directory
alias gpt-home="cd ~/gpt-home"

## Manage all services
alias gpt-up="cd ~/gpt-home && docker compose up -d"
alias gpt-down="cd ~/gpt-home && docker compose down"
alias gpt-restart="cd ~/gpt-home && docker compose restart"
alias gpt-logs="cd ~/gpt-home && docker compose logs -f"
alias gpt-status="cd ~/gpt-home && docker compose ps"

## Manage individual services
alias gpt-backend-logs="cd ~/gpt-home && docker compose logs -f backend"
alias gpt-backend-restart="cd ~/gpt-home && docker compose restart backend"
alias gpt-backend-shell="cd ~/gpt

readme truncated — read the full docs on github