Skip to content
Branch: master
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time


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/

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.


A Byteball bot that relays messages to members of your private chat group




No releases published
You can’t perform that action at this time.