Getting started

HomeGenie 2.0 Dashboard - Thermostat Schedule


Open media

HomeGenie 2.0 Dashboard - Local AI Chat - HTTP API


Open media

HomeGenie 2.0 Dashboard - Local AI Chat - Python API


Open media

HomeGenie 2.0 Dashboard - Local AI Chat - JavaScript API


Open media

HomeGenie 2.0 Dashboard - Floating Action Buttons


Open media

HomeGenie 2.0 Dashboard - Lights Control


Open media

HomeGenie 2.0 Dashboard - Shutters Control


Open media

HomeGenie 2.0 Dashboard - Smart Light Settings


Open media

HomeGenie 2.0 Dashboard - HomeFlix - Categories


Open media

HomeGenie 2.0 Dashboard - HomeFlix - Play on Smart TV


Open media

Installing HomeGenie 2.0

1. Download

Select your target operating system and architecture from the dropdown menu, then copy and paste the commands into your terminal to download and extract the latest release.

Select target architecture:

Enter the following commands in a PowerShell terminal:

# Download the archive
curl -L -o homegenie_2.0.5_win-x64.zip "https://github.com/genielabs/HomeGenie/releases/download/v2.0.5/homegenie_2.0.5_win-x64.zip"
# Unzip the archive
Expand-Archive -Path homegenie_2.0.5_win-x64.zip -DestinationPath . -Force

Enter the following commands in a terminal:

# Download the archive
curl -L -O "https://github.com/genielabs/HomeGenie/releases/download/v2.0.5/homegenie_2.0.5_osx-x64.zip"
# Unzip the archive
unzip homegenie_2.0.5_osx-x64.zip

Enter the following commands in a terminal:

# Download the archive
wget https://github.com/genielabs/HomeGenie/releases/download/v2.0.5/homegenie_2.0.5_linux-x64.zip
# Unzip the archive
unzip homegenie_2.0.5_linux-x64.zip

Enter the following commands in a terminal:

# Download the archive
wget https://github.com/genielabs/HomeGenie/releases/download/v2.0.5/homegenie_2.0.5_linux-arm.zip
# Unzip the archive
unzip homegenie_2.0.5_linux-arm.zip

Enter the following commands in a terminal:

# Download the archive
wget https://github.com/genielabs/HomeGenie/releases/download/v2.0.5/homegenie_2.0.5_linux-arm64.zip
# Unzip the archive
unzip homegenie_2.0.5_linux-arm64.zip

2. Run from Terminal

Once extracted, a homegenie folder will be created. Navigate into it and start the application:

cd homegenie
./HomeGenie

To stop the application, press CTRL + C in the terminal.

The video above demonstrates the installation process on a Raspberry Pi Zero 2 W using the official Raspberry Pi Imager with Raspberry Pi OS Lite (32-bit).

For instructions on how to run HomeGenie as a system service and for other advanced settings, please see the Optional Post-Installation Steps guide.

3. Access the UI

HomeGenie's user interface can be accessed from any web browser on your network.

URL: http://<server_ip>:<port>/

To find the exact address and port, check the serviceaddress.txt file in the homegenie folder after the first run:

cat homegenie/serviceaddress.txt

You can change the port settings from the Settings > Maintenance page or by manually editing the systemconfig.xml file (while the service is stopped).

📖

🕵🏻 Explore HomeGenie DeepWiki

Technical Docs & Interactive Wiki

Ask the AI 🧠
menu_open Content index
forum Q & A discussion forum
HomeGenie
SERVER 2.0 — Documentation