Ridges

Install Ridges miner CLI and toolkit with optional dependencies

pip install -e ".[miner]"

Initialize local miner configuration and workspace for runs, cache, and provider environment

ridges miner setup

Configure inference provider (OpenRouter, Targon, or Chutes) by filling generated .env.miner file based on env.miner.example template

# Edit <workspace>/.env.miner with inference provider credentials

Test agent locally against a Harbor task before submission

ridges miner run-local

Upload validated agent.py to the Ridges platform for evaluation

ridges upload --file agent.py

Clone the Ridges repository

git clone <repository>

Install Ridges core dependencies

pip install -e .

Start PostgreSQL, S3 mock, and API services using docker-compose

docker-compose up -d

Set up API configuration including database and S3 credentials

# Configure API environment in ./api/.env

Validators need Docker for running Harbor task containers and Kubernetes for production deployment

# Ensure Docker and Kubernetes/Minikube are available