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 (opens in a new tab). 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 !
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.
To install tentacles, OctoBot can either install a tentacle package bundle or a single tentacle from a local folder.
Tentacle package bundles are the prefered way to share tentacles.
Steps to create a tentacles package bundle from a local folder:
- Make sure it follows the OctoBot-Tentacles folders architecture (opens in a new tab)
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.
- Call OctoBot with the following arguments:
tentacles --pack "../tentacles_export.zip" --directory "path/to/your/local/tentacle_bundle"
You now have a tentacles_export.zip file. It is a tentacle bundle containing your tentacles packages that you can install and share.
To install a package bundle, call OctoBot with the following arguments:
tentacles --install --all --location "path/to/your/tentacles_export.zip"
You can also make it available from an URL and later install it via (for example) :
tentacles --install --all --location "https://my.tentacles.com/pack_name"
Installing a tentacle package will replace any existing source file that share the same name at the same path.
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
Evaluator/TA in this example).
- 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
__init__.pyfile. Your tentacle package has also to be imported in the parent folder
__init__.py. Please note that this parent
__init__.pyfile 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
files can be fixed by calling OctoBot with the following arguments: