MCB: Mini Chat Bot 🤖💬

MCB is a text processor for nodejs/browser chatbot. The goal is to be lightweight and in theory usable with any language.

Install

$ npm i mcb

Usage

import { MCB } from 'mcb'

// "Training" data
const data = [{
  intent: 'greetings.bye',
  utterances: ['goodbye for now', 'bye bye take care', 'okay see you later', 'bye for now', 'i must go'],
  answers: ['Till next time', 'See you soon!']
}, {
  intent: 'greetings.hello',
  utterances: ['hello', 'hi', 'howdy'],
  answers: ['Hey there!', 'Greetings!']
}]

const bot = new MCB({ data })
console.log(bot.process('goodbye for now').answer)
// => "Till next time" or "See you soon!"

Slot filling

Example code for slot filling:

import { MCB, btwEntity } from 'mcb'

const data = [{
  intent: 'travel.start',
  utterances: ['I want to travel'],
  answers: ['Where do you want to go?']
}, {
  intent: 'travelTo',
  utterances: ['to @city'],
  answers: ['From where you are traveling?'],
  cond: d => d.lastStep === 'travel.start'
}, {
  intent: 'travelFrom',
  utterances: ['from @city'],
  answers: ['When do you want to travel?'],
  cond: d => d.lastStep === 'travelTo'
}, {
  intent: 'travelDate',
  utterances: ['tomorrow', 'the @date'],
  answers: [d => `You want to travel from ${d.history.travelTo.city_val} to ${d.history.travelFrom.city_val} the ${new Date(d.date_val).toLocaleDateString('en-US')}`],
  cond: d => d.lastStep === 'travelFrom'
}, {
  intent: 'travalOneShot',
  utterances: ['I want to travel from @fromCity to @toCity at @date', 'I want to travel to @toCity from @fromCity at @date'],
  answers: [d => `You want to travel from ${d.fromCity_val} to ${d.toCity_val} the ${new Date(d.date_val).toLocaleDateString('en-US')}`]
}]

const entities = {
  date: /(\d{4}-\d{2}-\d{2}|\d{2}\/\d{2}\/\d{4})/gi,
  city: /(?:[\p{Letter}\p{Mark}]+(?:. |-| |'))*[\p{Letter}\p{Mark}]+/gu,
  fromCity: btwEntity('fromCity', ['from'], [' to ', ' the ', ' at ']),
  toCity: btwEntity('toCity', ['to'], [' from ', ' the ', ' at '])
}

const bot = new MCB({ data, entities })
console.log(bot.process('I want to travel').answer)
// => Where do you want to go?
console.log(bot.process('London').answer)
// => From where you are traveling?
console.log(bot.process('Paris').answer)
// => When do you want to travel?
console.log(bot.process('2022-12-15').answer)
// => You want to travel from London to Barcelona the 12/15/2022

console.log(bot.process('I want to travel from London to Barcelona the 12/15/2022').answer)
// => You want to travel from London to Barcelona the 12/15/2022'
console.log(bot.process('I want to travel to Barcelona from London the 12/15/2022').answer)
// => You want to travel from London to Barcelona the 12/15/2022

Alternatives / inspirations

• NLP.JS
• Rasa