A Byteball bot that relays messages to members of your private chat group
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



This is a documentation to help you to run your own private chat room chatbot.


This chatbot allows several persons to chat together using the Byteball messaging system. The bot decrypts messages and relays them to others users after reencryption. Since the messages are not anymore encrypted end-to-end, it is recommended to operate this bot by yourself instead of relying on a third party. Since it's based on a light headless wallet, any cheap VPS should be able to run it.

Welcome create room

Get started

At first start you will be asked to enter a device name and a passphase.

It should give you a pairing code as below:

====== my pairing code: AuB9N1V8OOdc9M5JrpNOCqI3LAcLWetitkT3MqK/Ij5U@byteball.org/bb#0000

Pair with the bot, create a chat room then give to your friend the custom pairing code allowing them to join the room you've created.


In conf.js file, you can set the following variables according to your preference:

exports.echoDisabled = false;

When false, the user will see his posted message. When true, no echo will be received.

exports.usersAllowedToCreateRoom = [];

If array empty, anybody can create a chat room. If it contains at least 1 address, room creation is restricted to device addresses present in array.