Join 10350+ others. No spamming.
I promise!

Follow us at github.



balloob / home-assistant


:house_with_garden: Open-source home automation platform running on Python 3


Home Assistant Build Status Coverage Status Join the chat at

Home Assistant is a home automation platform running on Python 3. The goal of Home Assistant is to be able to track and control all devices at home and offer a platform for automating control.

To get started:

python3 -m pip install homeassistant
hass --open-ui

Check out the website for a demo, installation instructions, tutorials and documentation.


Examples of devices it can interface it:

Built home automation on top of your devices:

  • Keep a precise history of every change to the state of your house
  • Turn on the lights when people get home after sun set
  • Turn on lights slowly during sun set to compensate for less light
  • Turn off all lights and devices when everybody leaves the house
  • Offers a REST API and can interface with MQTT for easy integration with other projects like OwnTracks
  • Allow sending notifications using Instapush, Notify My Android (NMA), PushBullet, PushOver, Slack, Telegram, and Jabber (XMPP)

The system is built modular so support for other devices or actions can be implemented easily. See also the section on architecture and the section on creating your own components.

If you run into issues while using Home Assistant or during development of a component, check the Home Assistant help section how to reach us.