🏡 Open source home automation that puts local control and privacy first.

asyncio hacktoberfest home-automation internet-of-things iot mqtt python raspberry-pi

Go to file

Fabian Affolter 5c79fc0ae3 Add link to docs		2015-10-25 15:58:58 +01:00
config	Added # comment for Sensor	2015-10-07 17:02:07 -04:00
docs	Update screenshot	2015-08-30 17:48:06 -07:00
homeassistant	Add link to docs	2015-10-25 15:58:58 +01:00
script	Re-enable Z-Wave for Docker	2015-10-24 11:36:34 -07:00
tests	Allow pipes in command sensors and services	2015-10-24 12:40:36 -07:00
.coveragerc	Exclude rest switch from coverage	2015-10-23 23:44:17 -07:00
.gitignore	Fix CI	2015-09-19 12:29:23 -07:00
.gitmodules	Remove latest git submodules	2015-09-08 20:11:25 -07:00
.travis.yml	Another try, caching is enabled before activating virtualenv	2015-10-03 11:36:39 -07:00
CONTRIBUTING.md	Moved plexapi import into setup_platform().	2015-09-21 11:59:55 -04:00
Dockerfile	Re-enable Z-Wave for Docker	2015-10-24 11:36:34 -07:00
LICENSE	Added MIT license	2013-10-08 21:18:22 -07:00
MANIFEST.in	Fix packaging issues	2015-10-10 10:33:09 -07:00
README.md	fixed merge conflict	2015-10-10 16:53:55 -04:00
pylintrc	Remove external from scripts and package info	2015-09-09 09:08:06 -07:00
pytest.ini	Fix CI	2015-09-19 12:29:23 -07:00
requirements.txt	Pip requirements and fixes.	2015-08-29 23:17:47 -04:00
requirements_all.txt	discovery: update Netdisco requirement	2015-10-24 12:18:48 -07:00
setup.py	Fix packaging issues	2015-10-10 10:33:09 -07:00

README.md

Home Assistant

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:

Monitoring connected devices to a wireless router: OpenWrt, Tomato, Netgear, DD-WRT, TPLink, ASUSWRT and any SNMP capable Linksys WAP/WRT
Philips Hue lights, WeMo switches, Edimax switches, Efergy energy monitoring, RFXtrx sensors, and Tellstick devices and sensors
Google Chromecasts, Music Player Daemon, Logitech Squeezebox, Plex, Kodi (XBMC), iTunes (by way of itunes-api), and Amazon Fire TV (by way of python-firetv)
Support for ISY994 (Insteon and X10 devices), Z-Wave, Nest Thermostats, RFXtrx, Arduino, Raspberry Pi, and Modbus
Interaction with IFTTT
Integrate data from the Bitcoin network, meteorological data from OpenWeatherMap and Forecast.io, Transmission, or SABnzbd.
See full list of supported devices

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.