Skip to content
Trading bot
Tentacles development
Customize your OctoBot

OctoBot is customizable!

You can easily create or add existing tentacles to your OctoBot.

Tentacles are evaluators (using social media, trend analysis, news, …), strategies (interpretations of evaluator’s evaluations), analysis tools (implementation of a bollinger bands in depth analysis, reddit entries reader, …) and trading modes.


OctoBot is available for free with basic implementations of a lot of different evaluators. The very high modularity in OctoBot’s architecture allows it to automatically look for the most advanced version(s) of all the available tentacles and automatically use them in its trading strategies.

Therefore, anyone can implement its own version of any evaluator, strategy, analysis tool and trading modes. It’s even possible to use another version provided by someone else !

Default tentacles

OctoBot default tentacles are automatically installed when first starting your OctoBot.

You can re-install them anytime using the following command arguments with your OctoBot:
tentacles --install --all

It is also possible to install a tentacles package using the web interface Tentacles tab.

Installing tentacles

To install tentacles, OctoBot can either install a tentacle package bundle or a single tentacle from a local folder.

Creating a tentacle package bundle

Tentacle package bundles are the prefered way to share tentacles.

Steps to create a tentacles package bundle from a local folder:

  1. Make sure it follows the OctoBot-Tentacles folders architecture to properly locate tentacles to be installed. There is no need to create empty folders but packages with content have to be at the appropriate path.
    Example: a trading mode should be located at Trading/Mode/name_of_your_trading_mode in your bundle.
  2. Call OctoBot with the following arguments:
tentacles --pack "../" --directory "path/to/your/local/tentacle_bundle"

You now have a file. It is a tentacle bundle containing your tentacles packages that you can install and share.

Installing the tentacle package bundle

To install a package bundle, call OctoBot with the following arguments:

tentacles --install --all --location "path/to/your/"

You can also make it available from an URL and later install it via (for example) :

tentacles --install --all --location ""

Installing a tentacle package will replace any existing source file that share the same name at the same path.

Installing a single tentacle package

It is also possible to install a single tentacle package from a local folder using the following arguments:

tentacles --single-tentacle-install "path/to/your/tentacle/to/install" Evaluator/TA

Please note that in this command, you also need to provide the type of the tentacle (Evaluator/TA in this example).

Installation troubleshoot

  • TentacleLoader Error when loading your_tentacle_module : This means the import of your tentacle module failed. Tentacles that can’t be imported by Python can’t be used.
  • Python doesn’t even see my tentacle: Your tentacle module has to be imported in your tentacle package file. Your tentacle package has also to be imported in the parent folder Please note that this parent file is managed by OctoBot and should already be properly filled when installing a tentacle bundle.
  • Python sees my tentacle but I can’t see it on the web interface: Your tentacle classes have to be listed in your user/profiles/NameOfYourProfile/tentacles_config.json. The web interface uses this file to list tentacles and check if they are enabled or not. This file is also kept up to date when installing a tentacle bundle.

In most cases, issues related to the parent and tentacles_config.json files can be fixed by calling OctoBot with the following arguments:

tentacles --repair