Disclaimer: We are temporarily not offering support for the Node-RED project. The reason for this is because we are focusing our attention on an official Node.js SDK and CLI Loader, rather than the forked and unsupported libraries that our Bean Node-RED project is currently based on. Once the Node SDKs and CLI Loaders are stable, we will determine if we need to rewrite the Node-RED implementation with the new SDKs, and fully support it again.


This guide will help you install Node-RED and the custom nodes used to communicate with Bean.

Install Node-RED

Since Node-RED uses Node.js it can be used on any of the core desktop platforms such as OS X, Windows and Linux. Go ahead and follow the installation guide provided by Node-RED to get it running on your system.

If you are interested in setting up a Raspberry Pi or BeagleBone Black for a dedicated Node-RED server, they have guides for that too.

Install Bean Nodes

Bean Nodes

These nodes are developed and maintained by Punch Through and must be installed seperately. First, it is important to understand that these nodes have a dependency on Bluetooth, since they are designed to talk to Bean. This is done by using a Node library called Noble.

Noble has it's own dependencies which need to be installed. Check out the prerequisites section of the project README before you continue.

Finally, in order to make use of Bean nodes, you must install them in a place that Node-RED can find them. Run the following commands in a terminal.

Mac OS X

  • mkdir -p ~/.node-red/node_modules
  • npm install --prefix ~/.node-red node-red-contrib-bean


  • mkdir -p %userprofile%/.node-red/node_modules
  • npm install --prefix %userprofile%/.node-red node-red-contrib-bean

Next Steps

Now that Node-RED and the Bean nodes are installed, you can start learning to use them to build flows with Bean!

Learn to Use Bean Nodes >>