ChatterBot is a machine-learning based conversational dialog engine build in Python which makes it possible to generate responses based on collections of known conversations. The language independent design of ChatterBot allows it to be trained to speak any language.
An example of typical input would be something like this:
user: Good morning! How are you doing?
bot: I am doing very well, thank you for asking.
user: You're welcome.
bot: Do you like hats?
An untrained instance of ChatterBot starts off with no knowledge of how to communicate. Each time a user enters a statement, the library saves the text that they entered and the text that the statement was in response to. As ChatterBot receives more input the number of responses that it can reply and the accuracy of each response in relation to the input statement increase. The program selects the closest matching response by searching for the closest matching known statement that matches the input, it then returns the most likely response to that statement based on how frequently each response is issued by the people the bot communicates with.
This package can be installed from PyPi by running:
pip install chatterbot
Note: The ChatBot object takes an optional parameter for the bot's name. The default name is 'bot'.
from chatterbot import ChatBot
chatbot = ChatBot("Ron Obvious")
After creating a new chatterbot instance it is also possible to train the bot. Training is a good way to ensure that the bot starts off with knowledge about specific responses. The current training method takes a list of statements that represent a conversation.
Note: Training is not required but it is recommended.
conversation = [
"Hello",
"Hi there!",
"How are you doing?",
"I'm doing great.",
"That is good to hear",
"Thank you.",
"You're welcome."
]
chatbot.train(conversation)
response = chatbot.get_response("Good morning!")
print(response)
Note: The default log file is database.db.
chatbot.database.set_path("path/to/file.db")
ChatterBot comes with a selection of useful chat bots built in.
This is a simple chatterbot that runs in the console. It responds to any user input that is entered.
from chatterbot import Terminal
terminal = Terminal()
terminal.begin()
This bot type integrates with various social networking sites to communicate.
from chatterbot import SocialBot
TWITTER = {
"CONSUMER_KEY": "<consumer_key>",
"CONSUMER_SECRET": "<consumer_secret>"
}
chatbot = SocialBot(twitter=TWITTER)
You will need to generate your own keys for using any API. To use this feature with twitter's api you will need to register your application at Twitter's developer website to get the token and secret keys.
Want to see what two bots have to say to each other? This allows your ChatterBot to talk to CleverBot.
from chatterbot import TalkWithCleverbot
talk = TalkWithCleverbot()
talk.begin()
Using ChatterBot in your app? Let us know!
See release notes for changes https://github.com/gunthercox/ChatterBot/releases