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; in0.1you 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, andseed. 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.