Sign upLogin

GladysProject/Gladys

View on GitHub
Star
README.md

Summary

Maintainability
Test Coverage
<h1 align="center">
  <br>
    <img src="https://gladysassistant.com/en/img/external/github-gladys-logo.png" width="200">
  <br>
  Gladys Assistant
</h1>

<h4 align="center">A privacy-first, open-source home assistant</h4>

<p align="center">
</p>

<p align="center">
  <a href="#try-gladys-assistant">Try</a> •
  <a href="#getting-started">Getting Started</a> •
  <a href="#contributors">Contributors</a> •
  <a href="#copyright--license">Copyright & License</a> 
</p>

<img src="https://gladysassistant.com/en/img/external/github-gladys-4-mockups-devices.jpg" />

## Try Gladys Assistant

You can try Gladys Assistant on our [demo website](https://demo.gladysassistant.com).

## Getting Started

To get started and install Gladys Assistant, you'll find everything on [our website](https://gladysassistant.com).

## Pull requests are welcome

If you want to help us develop on Gladys Assistant, you need to first setup your development environment locally.

- [MacOS/Linux instructions](https://gladysassistant.com/en/docs/dev/setup-development-environment-mac-linux/)
- [Windows instructions](https://gladysassistant.com/en/docs/dev/setup-development-environment-windows/)

Then, read [Contributing.md](https://github.com/gladysassistant/Gladys/blob/master/.github/CONTRIBUTING.md) to learn more about our GitHub flow.

## Contributors

Thanks goes to these wonderful people 👏

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
  <tbody>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://pierregillesleymarie.com"><img src="https://avatars0.githubusercontent.com/u/7365207?v=4?s=100" width="100px;" alt="Pierre-Gilles Leymarie"/><br /><sub><b>Pierre-Gilles Leymarie</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=Pierre-Gilles" title="Code">💻</a> <a href="#business-Pierre-Gilles" title="Business development">💼</a> <a href="https://github.com/GladysAssistant/Gladys/commits?author=Pierre-Gilles" title="Documentation">📖</a> <a href="#ideas-Pierre-Gilles" title="Ideas, Planning, & Feedback">🤔</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/VonOx"><img src="https://avatars2.githubusercontent.com/u/1528694?v=4?s=100" width="100px;" alt="Vincent KULAK"/><br /><sub><b>Vincent KULAK</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=VonOx" title="Code">💻</a> <a href="#infra-VonOx" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="https://github.com/GladysAssistant/Gladys/commits?author=VonOx" title="Documentation">📖</a> <a href="#ideas-VonOx" title="Ideas, Planning, & Feedback">🤔</a></td>
      <td align="center" valign="top" width="14.28%"><a href="http://www.trovato.fr"><img src="https://avatars2.githubusercontent.com/u/1839717?v=4?s=100" width="100px;" alt="Alexandre Trovato"/><br /><sub><b>Alexandre Trovato</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=atrovato" title="Code">💻</a> <a href="https://github.com/GladysAssistant/Gladys/commits?author=atrovato" title="Documentation">📖</a> <a href="#ideas-atrovato" title="Ideas, Planning, & Feedback">🤔</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/bertrandda"><img src="https://avatars1.githubusercontent.com/u/18148265?v=4?s=100" width="100px;" alt="Bertrand d'Aure"/><br /><sub><b>Bertrand d'Aure</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=bertrandda" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Terdious"><img src="https://avatars0.githubusercontent.com/u/35010958?v=4?s=100" width="100px;" alt="Terdious"/><br /><sub><b>Terdious</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=Terdious" title="Code">💻</a> <a href="#ideas-Terdious" title="Ideas, Planning, & Feedback">🤔</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/sescandell"><img src="https://avatars0.githubusercontent.com/u/1559970?v=4?s=100" width="100px;" alt="Stéphane"/><br /><sub><b>Stéphane</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=sescandell" title="Code">💻</a> <a href="#infra-sescandell" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#ideas-sescandell" title="Ideas, Planning, & Feedback">🤔</a></td>
      <td align="center" valign="top" width="14.28%"><a href="http://fischerdesign.co"><img src="https://avatars1.githubusercontent.com/u/8835133?v=4?s=100" width="100px;" alt="Scott Fischer"/><br /><sub><b>Scott Fischer</b></sub></a><br /><a href="#translation-Scott-Fischer" title="Translation">🌍</a></td>
    </tr>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/thib-rdr"><img src="https://avatars2.githubusercontent.com/u/6746308?v=4?s=100" width="100px;" alt="thib_rdr"/><br /><sub><b>thib_rdr</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=thib-rdr" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="http://www.callum-macdonald.com/"><img src="https://avatars0.githubusercontent.com/u/690997?v=4?s=100" width="100px;" alt="Callum Macdonald"/><br /><sub><b>Callum Macdonald</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=chmac" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Redshark30"><img src="https://avatars1.githubusercontent.com/u/38568609?v=4?s=100" width="100px;" alt="Redshark30"/><br /><sub><b>Redshark30</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=Redshark30" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/guillaumeLamanda"><img src="https://avatars0.githubusercontent.com/u/10440081?v=4?s=100" width="100px;" alt="Lamanda "/><br /><sub><b>Lamanda </b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=guillaumeLamanda" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/link39"><img src="https://avatars0.githubusercontent.com/u/2229692?v=4?s=100" width="100px;" alt="Thibaut Courvoisier"/><br /><sub><b>Thibaut Courvoisier</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=link39" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="http://lebarzic.fr"><img src="https://avatars2.githubusercontent.com/u/1555884?v=4?s=100" width="100px;" alt="Frédéric Le Barzic"/><br /><sub><b>Frédéric Le Barzic</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=hotfix31" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/NickDub"><img src="https://avatars1.githubusercontent.com/u/32032645?v=4?s=100" width="100px;" alt="NickDub"/><br /><sub><b>NickDub</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=NickDub" title="Code">💻</a></td>
    </tr>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="http://www.fotozik.fr"><img src="https://avatars3.githubusercontent.com/u/1773153?v=4?s=100" width="100px;" alt="Cyril Beslay"/><br /><sub><b>Cyril Beslay</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=cicoub13" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/callemand"><img src="https://avatars2.githubusercontent.com/u/11317212?v=4?s=100" width="100px;" alt="callemand"/><br /><sub><b>callemand</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=callemand" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/thebradleysanders"><img src="https://avatars2.githubusercontent.com/u/10698631?v=4?s=100" width="100px;" alt="Brad Sanders"/><br /><sub><b>Brad Sanders</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=thebradleysanders" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="http://robmccann.co.uk"><img src="https://avatars.githubusercontent.com/u/412744?v=4?s=100" width="100px;" alt="Rob McCann"/><br /><sub><b>Rob McCann</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=rob-mccann" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://bandism.net/"><img src="https://avatars.githubusercontent.com/u/22633385?v=4?s=100" width="100px;" alt="Ikko Ashimine"/><br /><sub><b>Ikko Ashimine</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=eltociear" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://ehtesham.dev"><img src="https://avatars.githubusercontent.com/u/38346914?v=4?s=100" width="100px;" alt="Ehtesham Siddiqui"/><br /><sub><b>Ehtesham Siddiqui</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=siddiquiehtesham" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/rpochet"><img src="https://avatars.githubusercontent.com/u/5940493?v=4?s=100" width="100px;" alt="Pochet Romuald"/><br /><sub><b>Pochet Romuald</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=rpochet" title="Code">💻</a></td>
    </tr>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="http://magarcia.io"><img src="https://avatars.githubusercontent.com/u/651610?v=4?s=100" width="100px;" alt="Martin Garcia"/><br /><sub><b>Martin Garcia</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=magarcia" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/euguuu"><img src="https://avatars.githubusercontent.com/u/9742965?v=4?s=100" width="100px;" alt="euguuu"/><br /><sub><b>euguuu</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=euguuu" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jbrisavoine"><img src="https://avatars.githubusercontent.com/u/138247436?v=4?s=100" width="100px;" alt="Jonathan Brisavoine"/><br /><sub><b>Jonathan Brisavoine</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=jbrisavoine" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/GziAzman"><img src="https://avatars.githubusercontent.com/u/14886739?v=4?s=100" width="100px;" alt="Alex"/><br /><sub><b>Alex</b></sub></a><br /><a href="https://github.com/GladysAssistant/Gladys/commits?author=GziAzman" title="Code">💻</a></td>
    </tr>
  </tbody>
</table>

<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

Read [Contributing.md](https://github.com/gladysassistant/Gladys/blob/master/.github/CONTRIBUTING.md) if you want to help us on Gladys Assistant.

## Articles

- [EN: Interview in Console #107](https://console.substack.com/p/console-104)
- [EN: Hackster.io - Gladys Assistant Is a Privacy-First Smart Home Platform — and Now Installable in Raspberry Pi Imager](https://www.hackster.io/news/gladys-assistant-is-a-privacy-first-smart-home-platform-and-now-installable-in-raspberry-pi-imager-4a84d5559c63)
- [FR: Framboise 314 - Plus de 500 installations pour l’assistant domotique Gladys !](https://www.framboise314.fr/plus-de-500-installation-pour-lassistant-domotique-gladys/)

## Copyright & License

Copyright (c) 2013-2023 Gladys Assistant - Released under the [Apache 2.0 License](https://github.com/gladysassistant/Gladys/blob/master/LICENSE).