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), LeRobot datasets, raw NumPy episodes. The native ROS 2 / LeRobot adapters land in 0.2; in 0.1 you serialize to a file and pass the path.
  • Storage. Video and large sensor blobs go to Cloudflare R2 via signed PUT URLs — bytes never touch our origin server. R2 is optional in dev (the SDK still tests the metadata path), required in production.
  • 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

  • Bugs / questions: hello@robotrace.dev
  • SDK source + issues: GitHub
  • Want a topic prioritized? Drop a line — we're tiny and we read everything.