Skip to main content

๐Ÿ‘‹ Welcomeโ€‹

@digital-alchemy is a Typescript based project that targets hobby / home automation type use cases. The project is organized as a framework, containing a generic core wiring library and a collection of plug-in libraries.

๐Ÿ”ฎ The Sightsโ€‹

Core Wiringโ€‹

The starting point for applications! Rules and types for building modules and wring them together in an ergonomic and automatically type safe way. Also contains helpers for:

  • โฐ scheduling
  • โš™๏ธ configuration
  • ๐Ÿงพ logging
  • ๐Ÿ‘ถ lifecycle events

Home Automationโ€‹

๐ŸŒ Hass

Tools for interacting with Home Assistant: entity & service calling proxies, registry apis, unit testing, and more.

๐Ÿง  Synapse + Custom Component

Create and manage virtual entities within Home Assistant. Modern config flow based integration with availability tied to the connection state of your app.

๐Ÿค– Automation

Build more complex logic with less code. Utility methods for doing solar & time calculations, coordinating areas, actively managed switches, and more.

๐Ÿš€ Quickstart

Install Digital Alchemy inside of a HAOS install. Use the built in Studio Code Server to edit your code, then build and run it within a dedicated Addon.

๐ŸŽฌ Type-Writer

Support script for translating your Home Assistant setup into Typescript to power your edit

Support Librariesโ€‹


Configuration and lifecycle friendly bindings for Fastify.


Bindings for publishing messages to MQTT & listening for messages


Api adapters for Grocy


Api adapters & types for Gotify