|📖 Documentation||⚗️ Cookbook||🖥 Website||💬 Community||📦 Modules||🚀 Roadmap|
Important: Make sure to join the official Slack Community (https://slack.botpress.io)!
Botpress is on mission to make bots ubiquitous and profitable for everybody. At Botpress, we think that using closed-source tools like Chatfuel is not the right approach for building awesome and powerful bots, but Chatfuel is great for quickly creating straight-forward conversational bots. To be able to create something great, it's important to have full control of your tools and to leverage the community efforts as much as possible.
Botpress is at an early stage and we are looking for nodejs developers to build new modules, create chatbots and help the community to build something that will be huge... Over time, everyone will benefit from having a powerful open-source ecosystem with a wide variety of specialized modules.
npm install -g botpress
Creating a bot is simple, you need to run
botpress init in a terminal inside an empty directory:
mkdir my-bot && cd my-bot && botpress initORbotpress init my-bot
Once your bot is created, you need to run
botpress start to start your bot:
This will provide you locally a web interface available at
At this point, your bot does nothing, you need to add features. There are two ways to add features:
For example, there's a
botpress-messenger module that will make your bot connect to Facebook Messenger and easily send/receive messages.
You can install modules directly in the web interface, or by using the
botpress install command:
botpress install messenger
Once installed, modules expose two things:
There are not a lot of modules yet, we count on the community to develop many useful ones! Please get in touch with us if you would like to develop modules but you are not sure on how to get started.
As the number of modules increase, we expect that the amount of code you'll need to write will lower everyday. Developers can add code directly in the bot (i.e.
index.js) and access the core and modules features. For example, if you wish to respond to a
GETTING_STARTED event on Facebook Messenger, you might code something along these lines:
To create a basic Hello Human bot in 3 minutes, please read the Getting Started.
For learn all concepts of Botpress, please read our Documentation
By default, anonymized usage statistics are sent to the Botpress Team. We rely on them to know where we need to allocate our efforts.
Note: we don't collect any personal information, we do not collect the content of the chats and nothing that could potentially breach your (or your user's) privacy. We use a one-way encryption algorithm to hash the data and we transmit them via a secure ssl connection. We also batch the data and make sure it won't slow down or interfere with your bot's performance.
In your Botfile, simply set the
optOutStats variable to
Here are some tutorials that might help you get started. They are easy to follow and take about 10 minutes to work through.
Here are some videos on YouTube that show you how to create and code your bot using Botpress.
Many more code examples are available in the Examples repository
The primary focus is to create as many good modules as possible to make Botpress the best platform for botmakers. We have a public Roadmap available on Trello, you can participate to it by voting for suggestions and adding new ones.
Here are a some modules that we think would be useful along with their assigned leader:
|botpress-inspector||no body yet|
|botpress-telegram||no body yet|
|botpress-kik||no body yet|
|botpress-sms||no body yet|
For starters, there are some open issues with the
for-new-contributors tag which are ideal for starting to contribute. They are all relatively easy to get started with.
If you would like to contribute any new feature or bug fix, please make sure that there is a GitHub issue first. If there is not, simply open one and assign it to yourself. If you are unsure on how to get started, ask us anything in the Slack or email us at
info [AT] botpress.io.
Contributions to Botpress will be dual-licensed under AGPLv3 and the Botpress Proprietary License. This means that all contributors need to agree to the dual-license before their contributions can be accepted.
Your next module here :) ? Please send a pull request!
There's a Slack community where you are welcome to join us, ask any question and even help others.
Get an invite and join us now! 👉https://slack.botpress.io
Botpress is licensed under an open source and commercial license. Even though it can be freely used and distributed under an open source license, this does not mean that there are no restrictions on its use. The main restriction is that any code that uses the botpress code under the open source license must be open source itself. For this reason commercial bots would normally be built using botpress licensed under the commercial license because commercial enterprises would want to use their own proprietary code with botpress and don't want to be forced to make this code open source. The commercial license has a cost for enterprises. Please visit our FAQS for more information.
By default, any bot created with Botpress is licensed under AGPLv3, but you may change to the Botpress License from within your bot's web interface in a few clicks.
For more information about how the dual-license works and why it works that way please see the FAQS.
Emoji provided free by EmojiOne