OLO Python SDK

Python SDK for controlling robots via ROS (Robot Operating System) through WebSocket connections.

Installation

pip install olo-client

Optional Dependencies

For WebRTC video streaming support:

pip install olo-client[video]

For all optional features:

pip install olo-client[full]

Quick Start

import asyncio
from oloclient import OLOClient

async def main():
    # Connect to ROS bridge
    async with OLOClient(ros_url='ws://localhost:9090') as client:
        # List available topics
        topics = await client.core.list_topics()
        print(f"Found {len(topics)} topics")

asyncio.run(main())

Standalone Platform Auth

For standalone SDK usage, create a personal access token in the OLO web app and pass it to the client.

import asyncio
from oloclient import OLOClient

async def main():
    client = OLOClient(
        server_url='wss://app.olo-robotics.com',
        api_url='https://app.olo-robotics.com',
        auth_token='olo_pat_your_token_here'
    )

    robots = await client.get_user_robots()
    await client.connect(robot_id=robots[0]['id'])
    print(await client.core.list_topics())

asyncio.run(main())

Username/password login is still available for compatibility, but two-factor-enabled accounts should use a personal access token instead of putting credentials in code.

Documentation

For full API documentation, see the OLO Documentation.