Installation¶
The recommended method for installing ChatterBot is by using pip.
Installing from PyPi¶
If you are just getting started with ChatterBot, it is recommended that you start by installing the latest version from the Python Package Index (PyPi). To install ChatterBot from PyPi using pip run the following command in your terminal.
pip install chatterbot
Optional dependencies¶
ChatterBot offers two collections of optional dependencies: dev and test. Neither of these are required for all ChatterBot use cases, but both provide full support for additional features. The dev collection includes dependencies such as pymongo, and pint (which are useful for working on various changes during development but are not required to use all chatterbot features). Separately the test collection includes dependencies such as flake8, and coverage. The specifics of each collection of optional dependencies can be reviewed via the project’s pyproject.yml file. To install these optional dependencies, you can use the following commands.
pip install chatterbot[dev]
pip install chatterbot[test]
pip install chatterbot[dev,test]
Similarly, if you have cloned the repository and want to install the optional dependencies, you can run commands in the following format:
pip install .[dev,test]
Installing from GitHub¶
You can install the latest development version of ChatterBot directly from GitHub using pip.
pip install git+git://github.com/gunthercox/ChatterBot.git@master
Installing from source¶
Download a copy of the code from GitHub. You may need to install git.
git clone https://github.com/gunthercox/ChatterBot.git
Install the code you have just downloaded using pip
pip install ./ChatterBot
Checking the version of ChatterBot that you have installed¶
If you already have ChatterBot installed and you want to check what version you have installed you can run the following command.
python -m chatterbot --version
