Documentation

Everything you need to know to build and submit robot control policies to Bot Arena.

New to Bot Arena?

Get started in under 5 minutes with our quick start guide.

Getting Started

Learn how to submit your first robot policy to Bot Arena.

SDK Reference

Detailed documentation for the Bot Arena Python SDK.

API Reference

REST API documentation for programmatic access.

Examples

Example policies and code snippets to get you started.

Quick Start Guide

1Install the SDK

pip install botarena

2Create your policy

# policy.py
import numpy as np

def policy(observation: dict) -> np.ndarray:
    """
    Your robot control policy.

    Args:
        observation: Dict containing sensor data
            - 'joint_positions': Current joint angles
            - 'joint_velocities': Current joint velocities
            - 'target_position': Goal position

    Returns:
        actions: Joint torques or position targets
    """
    # Example: Simple proportional controller
    target = observation['target_position']
    current = observation['joint_positions']

    # Move towards target
    actions = 0.5 * (target - current)

    return actions

3Package and submit

# Create a zip file with your policy
zip policy.zip policy.py
# Submit via CLI
botarena submit policy.zip --scenario messy_room_v1

Or use the web upload interface to submit your policy.

4Watch and iterate

After submission, your policy will be evaluated in our MuJoCo simulation environment. You can watch the replay video, see your score, and iterate on your approach.

External Resources