Installation

🤖 RussBot is a free, open-source binary options trading bot for PocketOption, built on BinaryOptionsToolsV2 → Get it on GitLab
💬 Need help? Join the Chipa Discord · ⚡ Go no-code with ChipaEditor

Everything you need to get RussBot running on your machine.

Requirements

1. Clone the Repository

git clone https://gitlab.chipatrade.com/chipadevorg/RussBot.git
cd RussBot

2. Create a Virtual Environment (Recommended)

# Create virtual environment
python -m venv .venv

# Activate (macOS/Linux)
source .venv/bin/activate

# Activate (Windows)
.venv\Scripts\activate

3. Install Dependencies

pip install pandas numpy BinaryOptionsToolsV2

Or use the pinned requirements file from the repo:

pip install -r requirements.txt

which contains:

pandas>=1.3.0
numpy>=1.21.0
BinaryOptionsToolsV2>=1.0.0

💡 Windows wheel: the repository also ships a prebuilt BinaryOptionsToolsV2 wheel (BinaryOptionsToolsV2-0.1.8-cp38-abi3-win_amd64.whl). If the PyPI install fails on Windows, install it directly: pip install BinaryOptionsToolsV2-0.1.8-cp38-abi3-win_amd64.whl

4. Verify the Installation

python -c "from BinaryOptionsToolsV2.pocketoption import PocketOptionAsync; import pandas, numpy; print('✅ RussBot dependencies ready!')"

The launcher also checks dependencies automatically every time you start the bot and tells you exactly what’s missing:

python run_bot.py

Windows Executable

If you don’t want to install Python at all, the repository includes a prebuilt Windows executable at dist/russ_trading_bot.exe. Download it from the GitLab repo and run it directly — it bundles Python and all dependencies.

The .spec files (trading_bot.spec, multi_asset_bot.spec, run_bot.spec) are PyInstaller build definitions if you want to rebuild the executable yourself:

pip install pyinstaller
pyinstaller run_bot.spec

Troubleshooting Installation

Import errors

pip install --upgrade BinaryOptionsToolsV2

Old Python version

RussBot needs Python 3.7+ with asyncio support. Check with python --version and upgrade if needed (use pyenv on macOS/Linux or download from python.org on Windows).

Still stuck?

• 💬 Ask on the Chipa Discord — the fastest way to get help
• 🐛 Open an issue on GitLab

Next Steps

Continue to Getting Started to extract your PocketOption SSID and run the bot for the first time. Prefer building strategies without code? Check out ChipaEditor.