genielabs / HomeGenie

HomeGenie The Programmable Intelligence, with 100% Local Agentic AI. www.homegenie.it HomeGenie is an open-source, cloud-independent ecosystem for smart automation. It provides everything you need to run your system locally, including firmware for DIY devices, a lightweight backend service, and mobile and tablet apps. It gives you full control over your environment, keeping your data strictly private. HomeGenie also features optional built-in AI. With simple chat commands, you can control your devices, build custom widgets, or create new automations. A demo configuration is included for an immediate, hands-on experience. The setup is entirely portable and lightweight: just download the ZIP, extract, and run. ✨ Key Features • **100% Local Agentic AI:** Run state-of-the-art LLMs directly on your HomeGenie server for autonomous reasoning, context awareness, and natural language control. Your data stays private, your intelligence stays local. • **AI Vision Suite:** Full integration of YOLO (Object Detection, Instance Segmentation, Pose Estimation) directly on server, ESP32-CAM modules, and generic IP cameras. • **Universal API & Programmability:** Automate anything with a fluent API programmable in **C#**, **JavaScript**, and **Python**. Create custom programs and widgets with full developer tools. • **Advanced Scheduler with Genie Commands:** Supports extended cron expressions, variables, conditions, and AI-driven natural language tasks for flexible automations. • **Customizable Dashboard & Widgets:** A modern, responsive UI with a powerful built-in editor to create and customize your own widgets using HTML, JavaScript, and CSS. • **Multi-protocol Support:** Integrated drivers for X10, Z-Wave, ZigBee, GPIO, SPI, I2C, IR/RF, and more. • **Smart Display & FPV Car Integration:** Transform ESP32 hardware into interactive smart displays or AI-powered FPV robotic platforms. • **Visual Programming:** Create complex scenarios intuitively with the Visual Program editor—no coding skills required. • **Voice Control & i18n:** Integrated support for voice commands and a fully localized UI across over 90 languages. • **Extensible:** Features groups, configuration backup, a package repository, and much more. Full Features and Image Gallery Documentation For detailed guides, API references, and tutorials, visit the official documentation website: **https://genielabs.github.io/HomeGenie** 💾 Installation You can find the latest release assets on the **GitHub Releases** page. Download the archive corresponding to your operating system and architecture: | Platform | Archive Name | |-----------------------|------------------------------------| | Windows (x64) | | | macOS (x64) | | | Linux (x64) | | | Raspberry Pi (32-bit) | | | Raspberry Pi (64-bit) | | After downloading, unzip the archive to your preferred location. 🚀 Starting HomeGenie Inside the extracted folder, you will find the directory containing the application binaries, along with a handy startup script specifically tailored for your operating system. Simply run the startup script to launch the server: • **Windows:** Double-click • **macOS:** Double-click • **Linux / Raspberry Pi:** Run from the terminal (or double-click if your file manager supports executing shell scripts). To gracefully stop the application, press in the terminal window. Running as a System Service HomeGenie can be run directly from a terminal for easy setup and testing, or installed as a system service for continuous, unattended operation. Linux (systemd) • (Recommended) Create a dedicated user for the service and move the application files: • Create a service definition file at : • Reload the systemd daemon, then start and enable the service: You can check the service status with . Windows HomeGenie can be installed as a Windows Service using the built-in commands. Open a Command Prompt **as an Administrator**, navigate to the directory, and run: For more options, see the official .NET documentation. Accessing the UI Once running, the HomeGenie user interface can be accessed from any web browser at: • is the IP address of the machine running HomeGenie. • The default is **80**, or the first available port starting from **8080**. You can find the exact address and port used by checking the file in the application folder. 🛠️ Post-Installation (Linux) To grant HomeGenie access to hardware like serial ports, USB devices, and GPIO, you may need to run additional commands. Audio & Voice Synthesis Serial Port & GPIO Access Add the user to the and groups: X10 (CM15/CM19) USB Controller • Install the required library: • Create a udev rule to grant access. Create the file with the following content: • Reload the udev rules and reconnect the device: 💻 Development Contributing Contributions are welcome! Please read the **CONTRIBUTING.md** file for guidelines. Repository Structure The main solution file is located in the repository root. • : The main application project, multi-targeted for and modern . • : Unit and integration tests. • : Utility libraries used by HomeGenie. • : Contains build assets, UI source code, and deployment scripts. Related Projects • https://github.com/genielabs/mig-service-dotnet • https://github.com/genielabs/homegenie-mini • https://play.google.com/store/apps/details?id=com.glabs.homegenieplus • https://github.com/zuixjs/zuix --- Disclaimer This software is provided "as is", without warranty of any kind. See the LICENSE file for more details.