Skip to content
Branch: master
Go to file


Failed to load latest commit information.
Latest commit message
Commit time

Gladys Assistant

A privacy-first, open-source home assistant

The ProjectGetting StartedLinksContributorsCopyright & License

The Project

Gladys is a home assistant who helps you in your everyday life.

Like a kind of JARVIS!

Gladys is connected to all your devices in your home. She is connected to your calendars and tons of API to help you.

But let's pick an example:

  • It's 8 AM. Gladys wakes you up automatically because she knows that you need to be at work at 9 AM, and that according to the traffic, you'll need 30min to go to work with your car. She knows that you like 30 min to get ready. She wakes you up with a soft progressive warm light thanks to your Philips Hue, and puts a nice music in your room.
  • It's 8.10 AM, Gladys detects thanks to a motion sensor that you are getting out of bed. She immediately starts the wake-up scenario : she tells the coffee machine to prepare the coffee, and opens the blinds.
  • At 8.30 AM, you leave the house. Gladys detects thanks to your smartphone that you are not at home anymore, and shuts down everything inside.
  • At 6.30 PM, you are getting back home : Everything is ready when you arrive. You are going to sleep, so you simply put your phone on your nightstand where a NFC tag is sticked. It immediately sends a request to Gladys to tell here you are going to sleep. She starts the "Going to sleep" scenario, and turns off all lights.

This is just a simple scenario, possibilities with Gladys are just endless. Don't hesitate to suggest yours 😉

Getting Started

Right now we are migrating from Gladys 3 to Gladys 4, a new release rewrote from scratch. If you want to install Gladys 3, visit our website.

To install Gladys 4 Beta, read the following instructions.

We use Docker to deploy Gladys 4, so it's easy to install it on any system.

On a Raspberry Pi

Read our tutorial: Install Gladys 4 on a Raspberry Pi

On MacOS/Windows

Read our tutorial: Install Gladys 4 on MacOS/Windows



Thanks goes to these wonderful people 👏

Pierre-Gilles Leymarie

💻 💼 📖 🤔

Vincent KULAK

💻 🚇 📖 🤔

Alexandre Trovato

💻 📖 🤔

Bertrand d'Aure



💻 🤔


💻 🚇 🤔

Scott Fischer


This project follows the all-contributors specification. Contributions of any kind welcome!

Read for more details.

Copyright & License

Copyright (c) 2013-2020 Gladys Assistant - Released under the Apache 2.0 License.

You can’t perform that action at this time.