RoboTrace

RoboTrace docs

Observability and evals for AI-powered robots. Log episodes (synchronized video, sensors, actions), replay them, version your datasets, and re-roll new policy versions against historical observations to measure regressions.

The Phase 1 product is invite-only and free during the pilot. The SDK and ingest API are live; the episode viewer and eval engine ship in Phases 6 and 7.

Start here

  • Quickstart - install the Python SDK, set your API key, log your first episode in five minutes.
  • log_episode - the one-shot SDK call. Every argument, every default, every breaking-change rule.
  • start_episode - the explicit lifecycle for streaming uploads and context-manager auto-finalize.
  • Errors - typed exception hierarchy and recovery patterns.
  • API keys - mint, rotate, and revoke the keys the SDK authenticates with.
  • Ingest API - the two HTTP endpoints underneath the SDK. Useful if you're writing a non-Python client or debugging an upload.

What's in scope (Phase 1)

  • Robot platforms. ROS 2 (Humble / Jazzy) via the ros2 adapter, LeRobot datasets (adapter coming), raw NumPy episodes. For formats without a native adapter, serialize to a file and pass the path to log_episode.
  • Storage. Video and large sensor blobs go to a private Cloudflare R2 bucket via signed PUT URLs - bytes never touch our origin server. The portal player streams them back via short-lived signed GET URLs minted on the fly. See Object storage for the full picture.
  • Reproducibility. Every episode keeps policy_version, env_version, git_sha, and seed. We don't drop these to "simplify" - they're the whole reason the future eval engine can re-roll a new policy against an old observation stream.

What's not in scope (Phase 1)

  • ROS 1. Out of scope. ROS 2 only.
  • Self-hosted deployment. RoboTrace runs on Vercel + Supabase + Cloudflare R2; we don't ship a Helm chart or Docker Compose for on-prem.
  • Stripe / paid tiers. Pilot is free until product-market fit.
  • Live two-way teleop streaming. Episode logging only; the observation stream is recorded then uploaded.

Sidebar legend

The left rail tracks everything the docs cover:

  • No badge - a real, ship-quality page.
  • Soon - a stub for an upcoming page. The URL is stable so any links you write today won't rot, but the content is being filled in.
  • New - recently shipped, may still get small revisions.

Help, feedback