mirror of https://github.com/home-assistant/core synced 2024-08-02 23:40:32 +02:00

Go to file

Paulus Schoutsen fd67e47128 Add tests for device_sun_light_trigger		2015-04-29 22:26:54 -07:00
config	ps: Add a global config object to Home Assistant	2015-03-18 23:02:58 -07:00
docs	Updated screenshots	2014-11-13 22:52:39 -08:00
homeassistant	Strip microseconds on state.last_updated	2015-04-29 08:18:53 -07:00
scripts	Use UTC as the internal datetime format	2015-04-28 19:12:05 -07:00
tests	Add tests for device_sun_light_trigger	2015-04-29 22:26:54 -07:00
.coveragerc	Update coveragerc to hide latest device components	2015-04-29 22:25:19 -07:00
.gitignore	Add python-version file to gitignore	2015-03-23 20:18:07 +00:00
.gitmodules	added HA module for mysensors	2015-04-02 19:59:44 +02:00
.travis.yml	Don't include device specific code in coverage	2015-03-07 07:49:19 -08:00
CONTRIBUTING.md	Update CONTRIBUTING.md	2015-04-23 09:58:43 -07:00
Dockerfile	Remove unneeded dependencies from Dockerfile	2015-03-15 16:00:03 -07:00
LICENSE	Added MIT license	2013-10-08 21:18:22 -07:00
pylintrc	Disable pylint unused-argument check	2015-01-19 23:40:51 -08:00
README.md	Forgot to add README.md file changes to last commit	2015-03-28 18:50:24 +11:00
requirements.txt	Use UTC as the internal datetime format	2015-04-28 19:12:05 -07:00

README.md

Home Assistant

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:

Track if devices are home by monitoring connected devices to a wireless router (supporting OpenWrt, Tomato, Netgear, DD-WRT)
Track and control Philips Hue lights
Track and control WeMo switches
Track and control Google Chromecasts
Track running services by monitoring ps output
Track and control Tellstick devices and sensors
Turn on the lights when people get home after sun set
Turn on lights slowly during sun set to compensate for light loss
Turn off all lights and devices when everybody leaves the house
Offers web interface to monitor and control Home Assistant
Offers a REST API for easy integration with other projects
Ability to have multiple instances of Home Assistant work together

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

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.