The LightBlue Bean is a legacy product and is no longer being sold

The Bean loader apps will continue to function, but no further updates will be provided. Updates to your OS may change Bluetooth functionality and therefore may break the functionality of the Bean apps.

Hardware files are available here.

We're proud to have helped people prototype their products with the Bean, and for all the incredible things they've built. The Bean was an incredibly fun and challenging product to work on, and we will miss it..

Our goal at Punch Through is to help companies develop products. Our consulting services and software products have been growing so quickly that they require our full focus and attention. If you're developing a connected product, we'd love to help in any way possible.



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 »