HomeGenie
SERVER 2.0 — Documentation

Cloud AI

While Local AI offers privacy and offline capabilities, cloud AI provides unmatched reasoning power and "Deep Knowledge" of your system. HomeGenie integrates seamlessly with any cloud AI provider like Google Gemini, transforming your smart home into an AI-powered development and orchestration environment where you can choose the model that best fits your workflow.

Google Gemini Integration

HomeGenie supports the latest generation of Gemini models (including 2.5 Flash and the ultra-fast 3.1 Flash-Lite), giving you a professional-grade coding partner and an autonomous agent directly in your dashboard.

HomeGenie AI

The Evolution of Intelligent Home Orchestration


Open media

Environment Awareness

The Intent Handler is more than just an assistant; it is a context-aware orchestrator. It doesn't just listen to words—it understands the state of your home.

Deep Context

Whenever you send a command, HomeGenie populates a dynamic template with:

Because Gemini "knows" your system's current state, it can make intelligent decisions like: "Since it's dark outside and you are coming home, I've turned on the porch lights for you."

Agentic Workflows

Automan (Automation Manager) represents the pinnacle of HomeGenie's agentic AI. It is not just an assistant; it is an Autonomous Orchestration Engine. Describe a complex task in natural language, and Automan will take full control of the lifecycle.

Interactive Smart Cards

Monitor real-time telemetry and control generated programs directly from the chat.


Open media

Polyglot Engine

Automan seamlessly generates and executes native Python, C#, and JavaScript code.


Open media

Integrated File Editor

View and edit AI-generated documents and reports without leaving the dashboard.


Open media

Complete Lifecycle Control

From logic design to real-time execution and safe background monitoring.


Open media

The Autonomous Lifecycle

  1. Polyglot Design: Automan translates your request into robust C#, Python, or JavaScript code, automatically choosing the best tool for the job.
  2. Deployment & Sandboxing: The code is deployed into a highly secure, OS-level sandboxed environment. Programs are compiled and launched seamlessly.
  3. Self-Healing Loop: If the system detects a compilation error, Automan captures the log, analyzes the failure, self-corrects the code, and re-deploys it without any human intervention.
  4. Agentic Chaining: For complex, multi-stage tasks separated by unpredictable events (e.g., waiting for a sensor to trigger), Automan creates a chain of short-lived, specialized agents that pass the baton to one another via the asynchronous Prompt.Schedule queue.
  5. Real-Time Telemetry & Cleanup: Generated programs communicate their status, messages, and progress directly to the UI. Once a temporary task is completed, Automan automatically disables and removes the program, keeping your system perfectly clean.

Your Co-Developer

While Automan handles background logic, the Widget Genie is your full-scale AI Co-Developer for frontend engineering. It assists you in building production-grade UI components directly within the HomeGenie interface.

The "Magic Loop"

When you have the Widget or Automation Editor open, the Genie becomes a live-coding partner:

Widget Wizard

One-click installation of AI-generated UI components.


Open media

Configuration

HomeGenie allows you to easily switch between different Gemini models to find the perfect balance between speed and reasoning.

  1. From the Chat: Open the AI Chat and click the gear icon in the top-right corner to configure Automan or Widget Genie.
  2. From Settings: Navigate to the System Settings page and locate the specific AI integration programs.

Key Settings

Configuring Gemini AI

Easily switch models and enable Deep Knowledge.


Open media

Obtaining your API Key

You don't need a paid subscription to use Gemini with HomeGenie. Google offers a generous Free Tier through Google AI Studio that is more than sufficient for personal home automation and coding assistance.

  1. Visit Google AI Studio: Go to aistudio.google.com.
  2. Sign In: Log in with your standard Google/Gmail account.
  3. Create API Key: Click on the "Get API key" button in the sidebar, then click "Create API key".
  4. Copy to HomeGenie: Copy the generated string (it starts with AIzaSy...) and paste it into the Google Gemini AI API key field in your HomeGenie settings.
Why use the Free Tier? The free tier currently supports the latest models like Gemini 3.1 Flash-Lite and includes Context Caching. It allows for several requests per minute, which is perfect for the "Magic Loop" development workflow in HomeGenie without incurring any costs.

Local vs. Cloud: Choose Your Strategy

FeatureLocal AI (Lailama)Cloud AI (Gemini)
Privacy🔒 100% Private (No data leaves home)☁️ Data processed by Google API
HardwareRequires RAM (8GB+) & CPU/GPULightweight (Zero server load)
IntelligenceReliable for daily tasks and chatSuperior for coding and deep reasoning
CachingN/AContext Caching for instant responses
SpeedDepends on your local hardwareHigh-speed (especially with 3.1 Flash-Lite)
Connectivity100% OfflineRequires active Internet connection

More topics

Setup

Features

Automation

Programming

📖

🕵🏻 Explore HomeGenie DeepWiki

Technical Docs & Interactive Wiki

Ask the AI 🧠
menu_open Browse Content