Repository files navigation

ChatterBot is a machine-learning based conversational dialog engine built inPython which makes it possible to generate responses based on collections ofknown conversations. The language independent design of ChatterBot allows itto 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.

View thedocumentationfor ChatterBot.

This package can be installed fromPyPi by running:

pip install chatterbot

fromchatterbotimportChatBotfromchatterbot.trainersimportChatterBotCorpusTrainerchatbot=ChatBot('Ron Obvious')# Create a new trainer for the chatbottrainer=ChatterBotCorpusTrainer(chatbot)# Train the chatbot based on the english corpustrainer.train("chatterbot.corpus.english")# Get a response to an input statementchatbot.get_response("Hello, how are you today?")

ChatterBot comes with a data utility module that can be used to train chat bots.At the moment there is training data for over a dozen languages in this module.Contributions of additional training data or training datain other languages would be greatly appreciated. Take a look at the data filesin thechatterbot-corpuspackage if you are interested in contributing.

fromchatterbot.trainersimportChatterBotCorpusTrainer# Create a new trainer for the chatbottrainer=ChatterBotCorpusTrainer(chatbot)# Train based on the english corpustrainer.train("chatterbot.corpus.english")# Train based on english greetings corpustrainer.train("chatterbot.corpus.english.greetings")# Train based on the english conversations corpustrainer.train("chatterbot.corpus.english.conversations")

Corpus contributions are welcome! Please make a pull request.

For examples, see theexamplessection of the documentation.

See release notes for changeshttps://github.com/gunthercox/ChatterBot/releases

1. Create a fork ofthemain ChatterBot repository on GitHub.
2. Make your changes in a branch named something different frommaster, e.g. createa new branchmy-pull-request.
3. Create a pull request.
4. Please follow thePython style guide for PEP-8.
5. Use the projectsbuilt-in automated testing.to help make sure that your contribution is free from errors.

ChatterBot is licensed under theBSD 3-clause license.