Giter VIP home page Giter VIP logo

botpress's Introduction

Botpress โ€” The only sane way of building great bots

CircleCI

Botpress is an open-source bot creation tool written in Javascript. It is powered by a rich set of open-source modules built by the community. We like to say that Botpress is like the Wordpress of Chatbots; anyone can create and reuse other people's modules.


Learn Botpress
๐Ÿ“– Documentation ๐ŸŽ“ Examples ๐Ÿฟ YouTube Tutorials
Follow us
๐Ÿ–ฅ Website ๐Ÿ’ฌ Slack ๐Ÿ“ฆ Modules ๐Ÿš€ Blog ๐Ÿฅ Twitter

โš ๏ธ Make sure you join our Slack Community for help, announcements, gigs and fun!

What is Botpress

Botpress is on a mission to make useful bots ubiquitous by powering developers with the best possible tools to build & manage chatbots. We believe that in order to create great bots, major time should be spent on UX, not on the surrounding (and generic) features.

Botpress is a free & open-source bot-building platform that ships with:

BotpressBotpressBotpress

Getting Started Quickly

The best way to get quickly get started using Botpress is to watch our video tutorials.

Botpress

Installation

Botpress requires node (version >= 4.6) and uses npm as package manager.

npm install -g botpress

Creating a bot

Creating a bot is simple, you need to run botpress init in a terminal inside an empty directory:

botpress init my-bot

Once your bot is created, you need to run botpress start to start your bot:

botpress start

This will provide you locally a web interface available at http://localhost:3000

Adding stuff to your bot

At this point, your bot does nothing, you need to add features. There are two ways to add features:

  • Installing modules
  • Coding

Installing modules

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:

  • A graphical interface (available in the left panel). This makes configuration easy and convenient. You don't need to know about coding to use the graphical interface.
  • Features via APIs. Each module has a detailed documentation on how to use their API.

Coding to add features

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:

bp.hear({ type: 'postback', text: 'GETTING_STARTED' }, (event, next) => {
  bp.messenger.sendText(event.user.id, 'Hello, human!')
})

To create a basic Hello Human bot in one minute, please read the Getting Started.

For learn all about Botpress, please read our full Documentation

Documentation

Modules

This is a non-exclusive list of modules Botpress has. See the full list of modules.

Module Maintainer
botpress-wit.ai @danyfs
botpress-subscription @slvnperron
botpress-terminal @slvnperron
botpress-analytics @danyfs
botpress-broadcast @slvnperron
botpress-rivescript @danyfs
botpress-messenger @slvnperron
botpress-slack @danyfs
botpress-discord @TheFreakLord
botpress-dialog @phildionne
botpress-scheduler @slvnperron
botpress-hitl @danyfs
botpress-api.ai @slvnperron
botpress-web @slvnperron

Contributing

Check out our contributing guide and our community code of conduct.

Community

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

License

Botpress is dual-licensed under AGPLv3 and the Botpress Proprietary License.

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.

Credits

Emoji provided free by EmojiOne

botpress's People

Contributors

slvnperron avatar matheusmatos avatar rayshih avatar hugojosefson avatar kirkwalk avatar jsalwen avatar shayanb avatar blazeu avatar rocel avatar northerncodemky avatar dhavalsoni2001 avatar wndisra avatar wac2007 avatar jonbaer avatar lesyk avatar ivanmayes avatar larkinscott avatar russellschmidt avatar maxim-mazurok avatar devenbhooshan avatar denisgorbachev avatar joepena avatar hdicksonjr avatar daehli avatar thisisrai avatar prayagverma avatar ofelt avatar lekoaf avatar justinwatson avatar jroo avatar

Watchers

James Cloos avatar Sawan Gupta avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.