ChatterBot Tutorial

This tutorial will guide you through the process of creating a simple command-line chat bot using ChatterBot.

Getting help

If you’re having trouble with this tutorial, you can post a message on Gitter to chat with other ChatterBot users who might be able to help.

If you believe that you have encountered an error in ChatterBot, please open a ticket on GitHub:

Creating your first chat bot

Create a new file named Then open in your editor of choice.

Before we do anything else, ChatterBot needs to be imported. The import for ChatterBot should look like the following line.

from chatterbot import ChatBot

Create a new instance of the ChatBot class.

bot = ChatBot('Norman')

This line of code has created a new chat bot named Norman. There is a few more parameters that we will want to specify before we run our program for the first time.

Setting the storage adapter

ChatterBot comes with built in adapter classes that allow it to connect to different types of databases. In this tutorial, we will be using the JsonFileStorageAdapter which is a simple storage adapter that stores data in a json formatted file on your hard disk. This functionality makes this storage adapter very good for testing and debugging.


The JsonFileStorageAdapter is not intended for use with large amounts of data. You may experience serious performance problems if the size of this database becomes too large.

We will select the JsonFileStorageAdapter by specifying it in our chat bot’s constructor.

The database parameter is used to specify the path to the database that the chat bot will use. For this example we will call the database database.json. The database.json file will be created automatically if it does not already exist.

bot = ChatBot(


The JsonFileStorageAdapter is ChatterBot’s default adapter. If you do not specify an adapter in your constructor, the JsonDatabase adapter will be used automatically.

Input and output adapters

Next, we will add in parameters to specify the input and output terminal adapter. The input terminal adapter simply reads the user’s input from the terminal. The output terminal adapter print’s the chat bot’s response.

bot = ChatBot(

Specifying logic adapters

The logic_adapters parameter is a list of logic adapters. In ChatterBot, a logic adapter is a class that take’s an input statement and returns a response to that statement.

You can choose to use as many logic adapters as you would like. In this example we will use two logic adapters. The TimeLogicAdapter returns the current time when the input statement asks for it. The MathematicalEvaluation adapter solves math problems that use basic operations.

bot = ChatBot(

Getting a response from your chat bot

Next, you will want to create a while loop for your chat bot to run in. By breaking out of the loop when specific exceptions are triggered, we can exit the loop and stop the program when a user enters ctrl+c.

while True:
     bot_input = bot.get_response(None)

    except(KeyboardInterrupt, EOFError, SystemExit):

Training your chat bot

At this point your chat bot, Norman will learn to communicate as you talk to him. You can speed up this process by training him with examples of existing conversations.

    'How are you?',
    'I am good.',
    'That is good to hear.',
    'Thank you',
    'You are welcome.',

You can run the training process multiple times to reinforce preferred responses to particular input statements. You can also run the train command on a number of different example dialogs to increase the breadth of inputs that your chat bot can respond to.

This concludes this ChatterBot tutorial. Please see other sections of the documentation for more details and examples.

Up next: Examples