Install tbot using

$ pip3 install -U --user git+

Also, if you haven’t done this already, you need to add ~/.local/bin to your $PATH.


tbot requires at least Python 3.6. Any version older than that will not work.

You can install tbot’s man-page using

$ sudo python3 install_data


tbot supports command line completions. Install them with the following commands:

curl --create-dirs -L -o .local/lib/tbot/
echo "source ~/.local/lib/tbot/" >>~/.bashrc


If the above did not work out of the box, take a look at the following list:

tbot not found

If your shell complains about the tbot command not existing, you have probably forgotten to add ~/.local/bin to your $PATH. Do this by adding the following line to your .bashrc or equivalent:

export PATH=~/.local/bin:$PATH

Installation successful, running tbot always throws an exception

If running tbot always throws an exception when run (even without any arguments), try forcing a clean reinstallation:

$ pip3 uninstall tbot
$ # In the tbot source directory
$ rm -rf build/ dist/ tbot.egg-info/
$ python3 install --user


If the installation does not work, most likely it is an error when installing paramiko. I recommend installing paramiko through your distros package manager (eg. python3-paramiko for Fedora). If your distros version of paramiko is too old, you will then need to install paramiko with pip (after installing the distro package):

$ pip3 install --user paramiko