Skip to main content

Kerttula

Kerttula™ is a home automation application built on top of 'Juham™' framework. It controls Juha's home.

Motivation

Yes, existing home automation solutions exist — for example, Home Assistant. I decided not to use any of them, because that would be incredibly boring. Instead, I chose to build one from scratch, because it seemed like a much more exciting way to learn Python and the GitLab ecosystem.

It hasn’t been all fun, though.

Sphinx and its extremely fragile .rst syntax have haunted me from day one. Python has tried to drive me crazy too — with its indentation-based structure, endless deprecations, random bugs, and the limitations of its type annotation system.

At several points I seriously regretted not writing everything in C/C++. But in the end, I don’t regret anything. Despite all the ups and downs, this project has been exactly what I needed to avoid wasting my spare time on something even more pointless.

Project Status

Current State: Alpha (Status 3)
In its current form, Kerttula™ may still resemble more of a distant mission (or even a "mess") than a "masterpiece," but I'm actively developing it to reach that goal!

Please check out the CHANGELOG <CHANGELOG.rst>_ file for changes in this release.

Installation

The installation is two stage process

  1. To install:

.. code-block:: python

pip install kerttula
  1. Configure

    OpenWeatherMap and various other services require you to register and obtain web keys and things like that. Most importantly, Influx DB and Graphana cloud accounts must be created for data visualization. Please consult 'juham' documentation for more information.

License

This project is licensed under the MIT License - see the LICENSE <LICENSE.rst>_ file.

Metadata

Release files for kerttula 0.1.28

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kerttula 0.1.28
File Size Uploaded
kerttula-0.1.28.tar.gz 6.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for kerttula 0.1.28
File Interpreter ABI Platform
kerttula-0.1.28-py3-none-any.whl Python 3 none any Details

Total release size: 12.5 kB

Release files / kerttula-0.1.28.tar.gz

Download URL kerttula-0.1.28.tar.gz
Size 6.4 kB
Tags Source
SHA-256 checksum
How to use checksums
531207f9599f9a1e859b8897a0ae23aab0b0c1e26871ceb2bc3ff8c18671b069
BLAKE2b-256 checksum
How to use checksums
5b54dee7e311e08b9613a3a69e19e2aff762d94f2d998d10dbcfdd5304e381fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / kerttula-0.1.28-py3-none-any.whl

Download URL kerttula-0.1.28-py3-none-any.whl
Size 6.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
987fac8aea03fbd5b14e7d537b17347caf83d1ab3cbd680ce2a966a1fae013be
BLAKE2b-256 checksum
How to use checksums
c4b92581638b044e59c3ad4387a260d177962cac864b570ce9a667b52d7d6cdf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page