Advanced usage
With Python only
Requirements
- Packages installed : Python3.8.X, Python3.8.X-dev, Python3.8.X-pip, git
Installation
First, make sure you have python3.8 and python3.8-dev and python3.8-pip installed on your computer.
Using the current stable version (master branch)
This is the recommended python installation.
Clone the OctoBot repository
1
git clone https://github.com/Drakkar-Software/OctoBot
Copied!
Install python packages :
1
cd OctoBot
2
python3 -m pip install -Ur requirements.txt
3
python3 start.py tentacles --install --all
Copied!
On some setup like 32-bit ARM architectures, you might get a
rust related error while running python3 -m pip install -Ur requirements.txt when installing cryptography. If this happens, you need to install the rust compiler: cryptography is coded in rust.1
sudo apt-get install -y rustc
Copied!
You can then restart
python3 -m pip install -Ur requirements.txt.Using the latest version (dev branch)
This is installation allows to use the most up-to-date version of OctoBot but might broken depending on the moment it is being done (modules updates might be in progress in this branch).
Clone the OctoBot repository using the dev branch
1
git clone https://github.com/Drakkar-Software/OctoBot -b dev
Copied!
Or if you already have an OctoBot repository
1
git checkout dev
2
git pull
Copied!
Install python packages :
On Unix
On Windows
1
cd OctoBot
2
python3 -m pip install -Ur requirements.txt
3
export TENTACLES_URL_TAG="latest"
4
python3 start.py tentacles --install --all
Copied!
1
cd OctoBot
2
python3 -m pip install -Ur requirements.txt
3
SET TENTACLES_URL_TAG=latest
4
python3 start.py tentacles --install --all
Copied!
Usage
The following command replaces OctoBot Launcher:
1
python3 start.py
Copied!
Python3
There python3 is refering to your Python3.8.X installation, just adapt the commands to match your setup if any different (might be python, python3, python3.8, etc: it depends on your environment).
Start in background
For unix distribution only
With the Linux screen command, you can push running terminal applications to the background and pull them forward when you want to see them.
1
sudo apt-get install -y screen
2
screen python3 start.py
Copied!
You need the number from the start of the window name to reattach it. If you forget it, you can always use the -ls (list) option, as shown below, to get a list of the detached windows:
1
screen -ls
2
screen -r 23167
Copied!
(23167 is an example value)
OctoBot has been working away in the background is now brought back to your terminal window as if it had never left.