How to Run a Predictoor Bot

1. Create a working directory

mkdir predictoor-run && cd predictoor-run

2. Place your ppss.yaml file

Copy the downloaded ppss.yaml file into this folder.

3. Export your private key

export PRIVATE_KEY=0xYOUR_PRIVATE_KEY_HERE

4a. Run with docker run

docker run --rm -it \
  -e PRIVATE_KEY=${PRIVATE_KEY} \
  -v $(pwd):/work \
  ghcr.io/oceanprotocol/pdr-backend:latest \
  pdr predictoor /work/ppss.yaml testnet

4b. OR run with docker-compose

If you downloaded the docker-compose.yml:

docker compose up -d

View logs: docker compose logs -f

Stop: docker compose down

1. Create a virtual environment

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

2. Install pdr-backend

pip install pdr-backend

3. Export your private key

export PRIVATE_KEY=0xYOUR_PRIVATE_KEY_HERE

4. Run the bot

pdr predictoor ppss.yaml testnet

View logs (Docker)

docker compose logs -f predictoor

Check outputs

Results are saved in the specified directory (out_dir in ppss.yaml).

Common errors

• PRIVATE_KEY not defined: Check the variable export
• Insufficient funds: Fund your wallet on the network
• Cron error: Check the cron schedule format
• Permission denied (Docker): Add your user to docker group

Docker

docker pull ghcr.io/oceanprotocol/pdr-backend:latest
docker compose restart

Python CLI

pip install --upgrade pdr-backend