ScriptsMay 30, 2026·3 min read

Gladys Assistant — Privacy-First Open-Source Home Automation

A self-hosted home assistant that runs locally on a Raspberry Pi, providing device control, scenes, automation rules, and a clean dashboard without cloud dependency.

Agent ready

Review-first install path

This asset needs a review step. The copied prompt tells the agent to dry-run, show the writes, then proceed only after confirmation.

Needs Confirmation · 64/100Policy: confirm
Agent surface
Any MCP/CLI agent
Kind
Skill
Install
Single
Trust
Trust: Established
Entrypoint
Gladys Assistant
Review-first command
npx -y tokrepo@latest install 34a978af-5be0-11f1-9bc6-00163e2b0d79 --target codex

Dry-run first, confirm the writes, then run this command.

Introduction

Gladys Assistant is a privacy-first, open-source home automation platform that runs entirely on local hardware. It is designed for users who want smart home control, scenes, and automation without sending data to external cloud services.

What Gladys Does

  • Controls Zigbee, Z-Wave, MQTT, and Wi-Fi smart home devices
  • Creates scenes and automations triggered by time, device state, or sensor data
  • Provides a responsive dashboard for monitoring rooms, devices, and cameras
  • Sends notifications via Telegram when automation events occur
  • Tracks presence using Bluetooth, network scanning, or GPS location

Architecture Overview

Gladys is a Node.js application with a SQLite database and a Preact-based frontend. It communicates with hardware through integration modules for Zigbee2MQTT, Z-Wave JS, Philips Hue, Sonoff, and other protocols. The system runs as a single Docker container on a Raspberry Pi or any Linux host, keeping all data local on the device's storage.

Self-Hosting & Configuration

  • Flash Raspberry Pi OS and install Docker, then run the Gladys container
  • Access the web UI to set up rooms, add devices, and configure integrations
  • Connect Zigbee devices through a Zigbee2MQTT coordinator
  • Define scenes with visual drag-and-drop condition and action builders
  • Set up Telegram bot integration for mobile notifications

Key Features

  • Fully local operation with no internet connection required after setup
  • Built-in camera support with live stream and motion-triggered recording
  • Multi-user accounts with per-user dashboards and presence tracking
  • Open integration API for connecting custom devices and services
  • Lightweight footprint suitable for Raspberry Pi 3 and newer

Comparison with Similar Tools

  • Home Assistant — far larger ecosystem but more complex setup and resource-heavy
  • OpenHAB — Java-based, powerful rule engine but steeper learning curve
  • Domoticz — lightweight but dated UI and smaller community
  • Node-RED — flow-based automation but requires separate dashboards and device management
  • ioBroker — modular German-origin platform with good Zigbee support but less polished UX

FAQ

Q: Which Zigbee coordinator does Gladys support? A: Any Zigbee2MQTT-compatible coordinator, including Sonoff ZBDongle-P and ConBee II.

Q: Can Gladys run on hardware other than Raspberry Pi? A: Yes. Any Linux machine with Docker support works, including x86 servers and NAS devices.

Q: Does Gladys support voice assistants? A: Gladys focuses on dashboard and automation control. Voice integration is not a core feature.

Q: How does Gladys compare to Home Assistant in scope? A: Gladys is intentionally smaller and simpler. It covers common smart home use cases without the complexity of a full platform.

Sources

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets