Skip to content

Open-source home automation platform running on Python 3

License

Notifications You must be signed in to change notification settings

torst/home-assistant

 
 

Repository files navigation

Home Assistant Build Status Coverage Status

This is the source code for Home Assistant. For installation instructions, tutorials and the docs, please see the website. For a functioning demo frontend of Home Assistant, click here.

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.

It offers the following functionality through built-in components:

Home Assistant also includes functionality for controlling HTPCs:

  • Simulate key presses for Play/Pause, Next track, Prev track, Volume up, Volume Down
  • Download files
  • Open URLs in the default browser

screenshot-states

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, reach out to the Home Assistant developer community.

Installation instructions / Quick-start guide

Running Home Assistant requires that python 3.4 and the package requests are installed. Run the following code to install and start Home Assistant:

git clone --recursive https://github.com/balloob/home-assistant.git
cd home-assistant
pip3 install -r requirements.txt
python3 -m homeassistant --open-ui

The last command will start the Home Assistant server and launch its webinterface. By default Home Assistant looks for the configuration file config/home-assistant.conf. A standard configuration file will be written if none exists.

If you are still exploring if you want to use Home Assistant in the first place, you can enable the demo mode by adding the --demo-mode argument to the last command.

Please see the getting started guide on how to further configure Home Asssitant.

About

Open-source home automation platform running on Python 3

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HTML 60.4%
  • Python 39.1%
  • Shell 0.5%