Practical overview
When it fits
Use Gpt Home when you want a self-hosted assistant that connects conversational AI to household tasks and the integrations listed by the project.
Who it is for
- People building a self-hosted conversational assistant for household routines.
- Raspberry Pi users who want to connect language-model services with supported home integrations.
- Developers looking for a Docker-based starting point for a home-assistant application.
Documented uses
- Ask for weather information or general knowledge.
- Set alarms and reminders, and work with calendar and to-do tasks.
- Use conversational access to supported music and smart-light integrations.
- Build and run a home assistant on a Raspberry Pi or server.
Requirements & limits
- The Raspberry Pi instructions require configuring a provider API key through LiteLLM.
- The README recommends a Pi 4B or 5, while listing a Pi Zero 2 W as the minimum.
- Audio devices need ALSA or PortAudio support.
- The documented integrations include Philips Hue and Spotify; Zigbee2MQTT is marked as not implemented.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up GPT Home on a Raspberry Pi
Install the Raspberry Pi deployment and configure its language-model API key.
Before you start
- Raspberry Pi Zero 2 W minimum; Raspberry Pi 4B or 5 recommended.
- Raspberry Pi OS Lite 64-bit or Ubuntu Server 64-bit.
- At least 512 MB RAM and 16 GB microSD storage; 1 GB or more and 32 GB or more are recommended.
- A LiteLLM-supported provider API key.
Steps
Run the repository's setup script with the --no-build option.
In ~/gpt-home, copy .env.example to .env and set LITELLM_API_KEY to your provider key.
Restart the services with docker compose down && docker compose up -d.
Optionally inspect the service logs with docker compose logs -f.
Expected outcome
The Raspberry Pi deployment is configured with an API key and its Docker Compose services started.
Guide limitations
- The documented provider list is handled through LiteLLM; a provider key is required.
- The README gives specific compatibility guidance for listed systems and does not vouch for every Linux configuration.
- Microphone and speaker support depends on ALSA or PortAudio compatibility.
Start the development environment
Prepare the repository's Docker Compose development profile and open its local interface.
Before you start
- A machine with Docker and Docker Compose.
- The repository and the required API keys.
Steps
Clone the repository and change into the gpt-home directory.
Copy .env.example to .env and add the API keys.
Start the development profile with COMPOSE_PROFILES=dev docker compose up, or use docker compose --profile dev up.
Open http://localhost.
Expected outcome
The development environment is started with hot reload, and the README directs users to the local interface at http://localhost.
Guide limitations
- The README describes this as a development setup, not the Raspberry Pi production procedure.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- judahpaul16/gpt-home · Official homepage title · retained in its source language