About Butter Bot
⚠️ This is pre-release software in active development. It is not yet in a usable state.
Butter Bot is a general purpose bot that can perform a variety of tasks asynchronously. Give it purpose and put it to work!
The Butter Bot package is available via npm as
butter-bot. The easiest way to get started is to install it on your system globally:
npm i --global butter-bot
Once installed, the
butterbot executable will be available on your system. To start the bot, simply run:
If everything is working correctly, the bot will continue running indefinitely until it is stopped manually. You can trigger a safe shutdown by sending the interrupt signal (CTRL + C).
Before the Butter Bot does anything useful, you need to give it purpose. You will need to define a task list, or connect it to a task server like Opdroid.com.
Command line options
For an overview of all command line and usage options, use
butterbot --help. You can also view the raw help text.
Butter Bot is modular. To add or extend its functionality, you can install packages that have been designed to work with it.
These packages are usually published on npm, and contain a
butterbot.json manifest file that describes what functionality it wants to expose to Butter Bot.
For more information on how packages are structured, or how to develop new (sub) packages for Butter Bot, please refer to the package development document.
Installing a package
To install and register a new Butter Bot package, simply run:
butterbot -i bb-sample-package
This will perform the npm installation as needed (without modifying our package.json), and register the package to the Butter Bot database file.
Once registered, Butter Bot will make sure the packages are available and installed as the correct version when it starts.