# Roborama

> Real robots as an API. Roborama runs your robot policy on physical, instrumented hardware and returns statistically defensible results: every success rate ships with its sample size and a Wilson 95% confidence interval (e.g. n=612, rate=0.874, ci95=(0.846, 0.898)). Robots pin firmware (g1-edu-pro@fw2.3), environments and benchmark suites pin revisions (kitchen-std@v1.2, rbr-manip-core@v3), so every result is reproducible and citable. Pricing is two meters — robot-hours × environment-hours — visible in every quote (600 humanoid episodes ≈ $3,740; see the worked example in pricing). Authentication: bearer API key (rbr_live_ prefix) in the ROBORAMA_API_KEY environment variable against https://api.roborama.com. Primitives: run, eval, verify, matrix, threshold, compare, transfer — all created via POST /v1/runs with a "kind" field. A customer claim is onboarded as a versioned Task Spec via POST /v1/tasks (lifecycle draft → pilot → frozen, e.g. espresso@v1) with instrument-bound success predicates; customer hardware ships in via POST /v1/kits. Simulation is a first-class input: verify() consumes sim-flagged scenarios and returns ground truth to recalibrate the simulator.

## Docs

- [Quickstart](https://roborama.com/docs/quickstart.md): key → run → result in under five minutes, including a complete POST /v1/runs example
- [Advanced quickstart](https://roborama.com/docs/quickstart-advanced.md): the end-to-end espresso flow — kit → Task Spec → freeze → verify → matrix, seven calls
- [run() — the core primitive](https://roborama.com/docs/primitives/run.md): every field of a run, with Python/TypeScript/cURL/tool-use examples
- [Tasks & method transfer](https://roborama.com/docs/concepts/tasks-and-method-transfer.md): claims as Task Specs — instrument-bound predicates, pilot/amend/freeze, object kits, complete POST /v1/tasks example
- [Runs & statistics](https://roborama.com/docs/concepts/runs-and-statistics.md): Wilson intervals and episodes="auto(ci=0.95, moe=0.03)" sizing
- [Policies](https://roborama.com/docs/concepts/policies.md): packaging a policy as container | checkpoint | endpoint
- [eval()](https://roborama.com/docs/primitives/eval.md): frozen, citable benchmark suites
- [verify()](https://roborama.com/docs/primitives/verify.md): the interlock with simulation
- [matrix()](https://roborama.com/docs/primitives/matrix.md): embodiments × environments grids
- [threshold()](https://roborama.com/docs/primitives/threshold.md): the soak-to-verify outcome contract
- [compare()](https://roborama.com/docs/primitives/compare.md) and [transfer()](https://roborama.com/docs/primitives/transfer.md): paired A/B and cross-embodiment gaps
- [Error codes](https://roborama.com/docs/errors.md): every API error, cause, and fix
- [Agent guide](https://roborama.com/docs/sdks/agents.md): tool names, markdown twins, and agent-native loops

## API

- [OpenAPI 3.1 specification](https://roborama.com/openapi.json): the full machine-readable API with examples on every operation — includes POST /v1/runs, POST /v1/tasks, POST /v1/kits, and POST /v1/quote
- [API reference (markdown)](https://roborama.com/docs/api-reference.md): the same surface as readable markdown, with per-group pages linked

## Pricing

- [Pricing & rate card](https://roborama.com/pricing.md): both meters, priority tiers, adders, packages, and the worked quote for 600 humanoid episodes ($3,740)
- [Quote fixture](https://roborama.com/fixtures/quote.json): the exact POST /v1/quote response shape

## Company & research

- [Product](https://roborama.com/product.md): cells, the data contract, the matrix, the verify loop
- [Research](https://roborama.com/research.md): verification arithmetic, reset economics, the transfer gap
- [Company](https://roborama.com/company.md): thesis and careers
- [Get a demo](https://roborama.com/demo.md): the demo-request form as a raw POST — endpoint, fields, and an example curl; agent-fillable, no captcha

## Optional

- [llms-full.txt](https://roborama.com/llms-full.txt): the entire documentation set concatenated as one markdown file
- [Sitemap](https://roborama.com/sitemap.xml)