Yet another python home automation project. Because a smart light is more than just on or off

Last update: Oct 10, 2022

Overview

Automate home

Yet another home automation project because a smart light is more than just on or off.

Overview

When talking about home automation there are at least two goals you could have in mind:

let a user interact with the home devices through many interfaces locally or remotely
let devices interact together and let the system change their state

I believe the other home automation projects fits perfectly the first goal, this project focuses on automation, the second one.

What's the difference between this project model and other home automation projects?

The main difference is the design of an Appliance where, with the name Appliance, I refer to entities like a light, a curtain, a sound player ecc.

One of the simplest Appliances I could imagine is a light with two physical states: on and off.

A light model could be designed like a deterministic state machine; all the other home automation projects I know do it like that.

Or it could be designed like a non deterministic state machine; which is how it is done by this project.

When using a deterministic state machine if you have a light with on/off physical states its model states will be just on/off. When using a non-deterministic state machine it is quite simple to have more model states for an on/off light, as an example, your light could be in an alarmed state and it could start blinking.

Behavior-driven development

I believe logics are the building bricks of a smart home system. Nevertheless, they are complex to build, debug and share and one of this project goals is to make it easier.

Having an Appliance grouping together all its logics simplifies debug and reuse.

All Appliances inner states can be tested with BDD style tests like this.

BDD style tests make it quite easy to understand the behaviour of every Appliance in every possible state and thus make it shareable.

I like to think of this project as a way to share behavioural models for our smart devices more easily.

Documentation

For a deep dive into this project see the documentation.

For a minute guide to this project see the landing page.

For suggestions, questions or anything else, please, write here: discussions.

Example GUI

Latest events

Devices collections

Lights

State of a light

Events history for a light

Events graphs for a light

Example projects

Using the docker image:

docker pull majamassarini/automate-home:latest

You might also like...

MultiPy lets you conveniently keep track of your python scripts for personal use or showcase by loading and grouping them into categories. It allows you to either run each script individually or together with just one click.

MultiPy About MultiPy is a graphical user interface built using Dear PyGui Python GUI Framework that lets you conveniently keep track of your python s

56 Oct 29, 2022

Generic automation framework for acceptance testing and RPA

Robot Framework Introduction Installation Example Usage Documentation Support and contact Contributing License Introduction Robot Framework is a gener

7.7k Jan 7, 2023

A folder automation made using Watch-dog, it only works in linux for now but I assume, it will be adaptable to mac and PC as well

folder-automation A folder automation made using Watch-dog, it only works in linux for now but I assume, it will be adaptable to mac and PC as well Th

31 May 28, 2021

A browser automation framework and ecosystem.

Comments

Remove Home Assistant token

Remove the Home Assistant token as it would lead to false-positives when using a SAST tool on the source code. I assume that the token was just a sample.

Also, updated some paths to avoid leaking details.

opened by fabaff 1

Releases(0.9.1)

0.9.1(Feb 20, 2022)

First public release
Source code(tar.gz)
Source code(zip)

Yet another python home automation project. Because a smart light is more than just on or off

Related tags

Overview

Automate home

Overview

Behavior-driven development

Documentation

Example GUI

Latest events

Devices collections

Lights

State of a light

Events history for a light

Events graphs for a light

Example projects

You might also like...

MultiPy lets you conveniently keep track of your python scripts for personal use or showcase by loading and grouping them into categories. It allows you to either run each script individually or together with just one click.

Generic automation framework for acceptance testing and RPA

A folder automation made using Watch-dog, it only works in linux for now but I assume, it will be adaptable to mac and PC as well

A browser automation framework and ecosystem.

Headless chrome/chromium automation library (unofficial port of puppeteer)

A complete test automation tool

Integration layer between Requests and Selenium for automation of web actions.

Command line driven CI frontend and development task automation tool.

Network automation lab using nornir, scrapli, and containerlab with Arista EOS

Comments

Remove Home Assistant token

Releases(0.9.1)

0.9.1(Feb 20, 2022)

Owner

Maja Massarini

a socket mock framework - for all kinds of socket animals, web-clients included

A single module to link Python ecosystem to the Web

Switch among Guest VMs organized by Resource Pool

A suite of benchmarks for CPU and GPU performance of the most popular high-performance libraries for Python :rocket:

hyppo is an open-source software package for multivariate hypothesis testing.

Declarative HTTP Testing for Python and anything else

pytest plugin for distributed testing and loop-on-failures testing modes.

A command-line tool and Python library and Pytest plugin for automated testing of RESTful APIs, with a simple, concise and flexible YAML-based syntax

UUM Merit Form Filler is a web automation which helps automate entering a matric number to the UUM system in order for participants to obtain a merit

WEB PENETRATION TESTING TOOL 💥

자동 건강상태 자가진단 메크로 서버전용

Command line driven CI frontend and development task automation tool.

Whatsapp messages bulk sender using Python Selenium.

Language-agnostic HTTP API Testing Tool

Mockoon is the easiest and quickest way to run mock APIs locally. No remote deployment, no account required, open source.

User-oriented Web UI browser tests in Python

Python tools for penetration testing

Automated Security Testing For REST API's

The async ready version of the AniManga library created by centipede000.

Android automation project with pytest+appium