GrandMoff100 / HomeAssistantAPI

Python Wrapper for Homeassistant's REST API
https://homeassistantapi.readthedocs.io
GNU General Public License v3.0
67 stars 19 forks source link
aiohttp api async hacktoberfest home-assistant home-automation python requests rest rest-api

HomeassistantAPI

Code Coverage PyPI - Downloads GitHub commits since latest release (by date including pre-releases) Read the Docs (version) GitHub release (latest by date)

Python wrapper for Homeassistant's REST API

Here is a quick example.

from homeassistant_api import Client

with Client(
    '<API Server URL>',
    '<Your Long Lived Access-Token>'
) as client:

    light = client.get_domain("light")

    light.turn_on(entity_id="light.living_room_lamp")

All the methods also support async! Just prefix the method with async_ (i.e. await light.async_turn_on(...)).

Documentation

All documentation, API reference, contribution guidelines and pretty much everything else you'd want to know is on our readthedocs site here

If there is something missing, open an issue and let us know! Thanks!

Go make some cool stuff! Maybe come back and tell us about it in a discussion? We'd love to hear about how you use our library!!

License

This project is under the GNU GPLv3 license, as defined by the Free Software Foundation.