This module integrates inside Botpress for NLP

Usage no npm install needed!

<script type="module">
  import botpressWit from '';



The easiest way to create a bot with Botpress

Getting started

botpress install wit

The module should now be available in your bot UI


This module has two modes: Understanding (message API) and Stories (converse API).


This mode will inject understanding metadata inside incoming messages through the middleware.

Events will have a wit property populated with the extracted entities and the context.

Tip: Use this mode if you want to handle the conversation flow yourself and only want to extract entities from incoming text. This is great for programmers.

bp.hear({'wit.entities.intent[0].value': 'weather'}, (event, next) => {
  console.log('>> Weather')
  bp.messenger.sendText(, 'Weather intent')


This mode will run your stories automatically given that you defined the Actions in botpress.

For more information about Actions and how they are run, make sure to read node-wit's documentation.

Tip: Use this mode if you created a conversation flow on's User Interface and want it to run automatically in your bot. This is great for non-programmers.


// Implement your Actions like this
bp.wit.actions['getWeather'] = request => {
  return new Promise((resolve, reject) => {'Get Weather called', request)
    // Do something here

// You need to call this method once you are done implementing the Actions


Pull requests are welcomed! We believe that it takes all of us to create something big and impactful.

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! 👉


botpress-wit is licensed under AGPL-3.0