Metadata-Version: 2.0
Name: ChatterBot
Version: 0.0.3
Summary: An open-source chat bot program written in Python.
Home-page: https://github.com/gunthercox/ChatterBot
Author: Gunther Cox
Author-email: gunthercx@gmail.com
License: BSD
Keywords: ChatterBot,chatbot,chat,bot
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: fuzzywuzzy (==0.3.2)

ChatterBot
==========

This library allows developers to create language independent chat bots
that return responses to based on collections of known conversations.

|Package Version| |Build Status| |PyPi| |Coverage Status|

| 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: Your welcome.
| > bot: Do you like hats?

Installation
------------

This package can be installed using

::

    pip install chatterbot

Useage
------

| Create a new chat bot
| **Note:** This object takes an optional parameter for the bot's name.

::

    from chatterbot import ChatBot
    chatbot = ChatBot("Ron Obvious")

Getting a response to input text

::

    response = chatbot.get_response("Good morning!")
    print(response)

| Specify a defult location for conversation log files
| **Note:** The default log directory is ``conversation_engrams/``.

::

    chatbot.log_directory = "path/to/directory/"

Terminal mode (User and chat bot)

::

    from chatterbot import Terminal
    terminal = Terminal()
    terminal.begin()

Have the chat bot talk with CleverBot

::

    from chatterbot import TalkWithCleverbot
    talk = TalkWithCleverbot()
    talk.begin()

Notes
-----

Sample conversations for training the chatbot can be downloaded from
https://gist.github.com/gunthercox/6bde8279615b9b638f71

This program is not designed to be an open source version of CleverBot.
Although this **Chat Bot** returns responces, the code here handels
communication much differently then
`CleverBot <http://www.cleverbot.com>`__ does.

.. |Package Version| image:: https://badge.fury.io/py/ChatterBot.png
   :target: http://badge.fury.io/py/ChatterBot
.. |Build Status| image:: https://travis-ci.org/gunthercox/ChatterBot.svg?branch=master
   :target: https://travis-ci.org/gunthercox/ChatterBot
.. |PyPi| image:: https://pypip.in/download/ChatterBot/badge.svg
   :target: https://pypi.python.org/pypi/ChatterBot
.. |Coverage Status| image:: https://img.shields.io/coveralls/gunthercox/ChatterBot.svg
   :target: https://coveralls.io/r/gunthercox/ChatterBot




History
-------

`See release notes 
<https://github.com/gunthercox/ChatterBot/releases>`_


