tbot supports running on Linux only. Other UNIXes might work but are not tested.

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


  1. Install tbot using

    $ pip3 install -U --user git+
  2. If you haven’t done this already, you need to add ~/.local/bin to your $PATH.

  3. 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


Note that paramiko is no longer a required dependency.

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