About this project

Gladys Assistant is an open-source smart home assistant positioned around privacy: it is designed to run on your own hardware rather than depending on a vendor cloud. The README presents it as a "privacy-first, open-source smart home assistant" and shows a dashboard screenshot. Deployment is centered on Docker. The README gives a single `docker run` command that starts a local instance, using host networking, a persistent SQLite database file under `/var/lib/gladysassistant`, and mounts for the Docker socket, `/dev`, udev and D-Bus. A Docker Compose installation guide is also referenced. The project states it supports installation on mini-PCs, NAS devices and Raspberry Pi, with step-by-step instructions on its official website. Beyond installation, the README focuses on community and contribution. It links to development environment setup guides for macOS/Linux and Windows, a contributing guide describing project structure and pull requests, and a community forum. The project explicitly welcomes AI-assisted development and points contributors to an `AGENTS.md` file for working on the codebase. A contributors table lists many people credited with code, documentation, translation, infrastructure, ideas and business development, following the all-contributors specification. The repository is licensed under Apache 2.0. The README also links to external articles, including an interview and coverage about Raspberry Pi Imager installability. No specific device integrations, protocol support, automation features or performance claims are detailed in the README itself; those would need to be verified from the documentation site or source code.