Extensions (via Docker)
Extensions allow you to expand the platform's capabilities using container technology. Fundamentally, an extension is a standard Docker image that the Heisenware platform loads, executes, and exposes as visual functions within the App Builder.
There are two categories of extensions:
Official extensions (Heisenware made): Ready-to-use, managed modules maintained by us.
Custom extensions (user-made): Your Docker images containing custom algorithms, drivers, or logic (also known as Docker custom code adapters).
Official extensions
These are pre-built modules provided by Heisenware to add advanced capabilities without any coding. Currently, we offer the following official extensions:
Industrial blockchain: For immutable data logging and audit trails.
RAG AI: Retrieval-Augmented Generation for context-aware AI assistants.
Process simulations: Simulates energy consumption and silo fill levels
Once installed, these extensions run alongside the standard platform functionality. They appear as new blocks in your functionality library and can be used immediately in your flows.
Custom extensions
This is a powerful feature that allows you to extend the Heisenware platform to your specific needs.
In essence, we provide you with a project setup into which you can add your custom functionality in a completely non-intrusive fashion. Using the power of our VRPC library under the hood, you can write any valid Node.js code (yes - no APIs nothing, just your code) and make it ready for visual programming in minutes.
We are actively working on having the same idea ready for C++ and Python, stay tuned!
The best place to start is by looking at our docker-extension-starter-js. Actually, we recommend downloading this project as a scaffold for you to change it to your needs and place it under your software versioning.
What you end up doing is creating a Docker image whose containers nicely integrate into the platform in one of two possible ways:
Running in the cloud - inside the platform
Once your Docker image is built, pushed, and publicly accessible (contact us for private registry support), you can easily load it as a Custom Extension
Once installed and given your code is syntactically correct, it immediately appears in the Functionality tree view. Simply install it again if you have a new version (even works with the same label) to be applied.
Any instances you create will be automatically persisted and restarted. You will find them in the Resources under extensions/my-extension/...
Running anywhere - outside of the platform
This is a powerful feature. It allows you to run your custom code on-premises but automatically, seamlessly, and securely bridged into the cloud by us. To accomplish that, you simply start a container of the image you created locally and configure it with the correct credentials using environmental variables.
To retrieve a valid username and password, add a VRPC Integration in the App Manager.
Example
For an account named my-company, an integration with username agentRunner and a password called secret the call would be:
When everything is set up correctly, you should see something like this on your console:
Last updated
Was this helpful?