If you have a question, please just open a dialog in the “issue” section so others can benefit from the discussion.
This project is interested in collaborating with integration of the Zigbee2mqtt NodeJS API https://www.npmjs.com/package/zigbee2mqtt
This framework was built with Home Assistant GUI in mind but even if you don't require Home Assistant, Telegram, or ESPHome integration, this framework provides essential features such as UDP communications, a debugging website, timer functions, logging, notifications, a service installer, and straightforward management of both volatile and non-volatile memory storage.
ThingWerks is an ultra-lightweight IoT Automation Framework for NodeJS, intended to enable users to swiftly create automation scripts in NodeJS. Tailored for both industrial and home automation projects, its primary goal is to expedite the setup of a basic automation system.
Ready made industrial TW-Client automations will be included here in this repo such as PumperPro
TW-Core serves as the central hub for handling communication, system management, and overall system functions. On the other hand, the TW-Client is purposefully streamlined, containing only essential code to communicate with the Core, making it the designated space for your automation code. This intentional separation is crafted to enhance system reliability and simplicity. By compartmentalizing responsibilities, this design choice facilitates a more straightforward deployment of future enhancements, ensuring an efficient and robust framework for automation development.
This framework utilizes Home Assistant's robust GUI, smartphone app, and monitoring capabilities for NodeJS automations, offering a more reliable, flexible, and responsive approach than relying on Home Assistant for complex tasks. Coding basic logic in JavaScript is argued to be simpler than using the GUI or YAML.
While Home Assistant excels in certain scenarios, it is unsuitable for industrial applications, where malfunctions can cause costly equipment damage. Managing data within Home Assistant is challenging, with slow responsiveness to inputs and significant lag. Despite these challenges, Home Assistant serves well as a monitoring and control mechanism within the framework.
In more complex environments with multiple sensors and outputs, Home Assistant falls short. NodeJS proves more suitable, handling intricacies with reliability and efficiency.
The TW IoT with Home Assistant (HA) solution is highly compact and resource-efficient, especially with Home Assistant Core, which operates stably with just 500MB of RAM—unlike Home Assistant Supervised. During testing, Home Assistant Supervised consistently crashed with 1GB of RAM. The ESP Home web interface easily installs alongside HA Core, creating an efficient platform for modest IoT devices with 1GB of RAM.
A key point is the remarkable responsiveness of the HA Core API, averaging 2-5ms with no timeouts. In contrast, Home Assistant Supervised can exhibit latency exceeding 100ms, occasionally becoming completely unreachable or crashing, likely due to resource-intensive background updates. Thus, using Home Assistant Supervised for reliable, time-critical operations is strongly advised against.
- Has very stable power and network loss recovery
- Functions as an ESPHome subscriber
- Supports Telegram for monitoring and remote control
- Has web-based debugger for your automation
- Has a nice and easy to use logging function
- Has SystemD service creator
- TW IoT completely removes all need for automation logic and control in Home Assistant
- This framework is immune to network interruptions with HA
- Has full support for HA Websocket API
- System keeps track of HA latency and availability and notifies you if something is wrong
- Adds industrial level reliability to Home Assistant
- Gives Home Assistant full support of automation with NodeJS
- Supports multiple home assistant server connections
- Can be used as a relay agent for Home Assistant
- Can synchronize two separate Home Assistants