GladysAssistant/Gladys

GladysAssistant/Gladys has 3,271 GitHub stars and 334 forks. GitHot measured +1 stars in 24 hours. Last checked 2026-11-07 00:37 UTC. Last push 2026-11-02.

How these counts are measured

A privacy-first, open-source home assistant

3,271 stars 334 forks +1 in 24h

Measured star growth

in 24h: +1
in 7 days: Collecting history
in 15 days: Collecting history
in 1 month: Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

Gladys Assistant

Your privacy-first, open-source smart home assistant

Try It • Getting Started • Contribute • Contributors • License

Gladys Assistant dashboard

🚀 Try Gladys Assistant

Spin up a local Gladys Assistant instance in seconds using Docker:

sudo docker run -d \
  --log-driver json-file \
  --log-opt max-size=10m \
  --cgroupns=host \
  --restart=always \
  --privileged \
  --network=host \
  --name gladys \
  -e NODE_ENV=production \
  -e SERVER_PORT=80 \
  -e TZ=Europe/Paris \
  -e SQLITE_FILE_PATH=/var/lib/gladysassistant/gladys-production.db \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/gladysassistant:/var/lib/gladysassistant \
  -v /dev:/dev \
  -v /run/udev:/run/udev:ro \
  -v /run/dbus:/run/dbus:ro \
  gladysassistant/gladys:v5

Prefer using Docker Compose? Check out our Docker Compose installation guide.

📚 Getting Started

To install Gladys Assistant on your smart home setup, head over to our official website for a step-by-step guide.

Whether you're installing on a mini-PC, a NAS or a Raspberry Pi, we've got you covered with clear instructions tailored to your setup.

🤝 Contribute to Gladys

We welcome contributions of all kinds — code, documentation, translations, or feature ideas.

Gladys is built by an open-source community, and you can be a part of it!

1. Set up your development environment

Follow the guide that matches your system to get started:

2. Start developing

Once your environment is ready, dive into our contributing guide to understand the project structure, how to build features, and how to open a pull request.

3. AI-assisted development is welcome

We use AI extensively to build Gladys ourselves, and we're very favorable to AI-assisted contributions. Read the AI-assisted development section of our contributing guide, and point your agent to AGENTS.md: it contains everything needed to work on this codebase.

🧑‍💻 Contributors

A huge thank you to all our amazing contributors! 💜
Gladys wouldn't be where it is today without your help.

Thanks goes to these wonderful people 👏

_{Pierre-Gilles Leymarie} 💻 💼 📖 🤔	_{Vincent KULAK} 💻 🚇 📖 🤔	_{Alexandre Trovato} 💻 📖 🤔	_{Bertrand d'Aure} 💻	_Terdious 💻 🤔	_Stéphane 💻 🚇 🤔	_{Scott Fischer} 🌍
_{thib_rdr} 📖	_{Callum Macdonald} 📖	_Redshark30 📖	_Lamanda 💻	_{Thibaut Courvoisier} 💻	_{Frédéric Le Barzic} 💻	_NickDub 💻
_{Cyril Beslay} 💻	_callemand 💻	_{Brad Sanders} 📖	_{Rob McCann} 💻	_{Ikko Ashimine} 📖	_{Ehtesham Siddiqui} 📖	_{Pochet Romuald} 💻
_{Martin Garcia} 💻	_euguuu 💻	_{Jonathan Brisavoine} 💻	_Alex 💻	_Nagromdark 💻	_{vincentBesseau} 💻 🤔	_{William Deren} 💻