Diagnose missing action chunks, step acknowledgements, and observation mapping.
Symptom
Check
Connection rejected or no capacity
Use https://api.reactor.inc, the correct model identifier, and an authorized key. Capacity errors can occur before inference; retry with backoff or contact Reactor.
No first chunk
Wait for READY before publishing. All three named tracks must deliver frames, and proprio_json must parse as row lists.
No next chunk
Report the last received step after execution. Repeating the same or an older step does not request another prediction.
State ignored
Encode JSON as a string inside the named command payload. Check the 8,000-character limits and row widths.
Correct shape, wrong motion
Check camera identities, joint ordering/units, and absolute-target interpretation. Tensor shape does not prove embodiment compatibility.
Gripper moves the wrong way
DROID uses 0 open and 1 closed. Convert your driver’s units/polarity explicitly.
Values differ on identical inputs
Sampling is unseeded and video transport can change the received pixels; exact numerical equality is not a supported check.
Unexpected step after reset
Reset restarts the counter but preserves input fields. Use a new session when old acknowledgements or replies could be mistaken for new ones.
Reference-client behavior
Keep the event loop responsive so camera publishing and message handling can continue. Start a fresh
session after an uncertain timeout; do not fabricate an acknowledgement to force progress. The
documented endpoint supports reset as specified in the
reference.
Report a problem
Include the model identifier, SDK/client versions, session ID, timestamps, track names/shapes,
proprioception dimensions, last received and acknowledged counters, and exact error text. Never
include an API key. State whether the failure occurred during connection, first prediction, or
subsequent control steps.
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Reactor","description":"Reactor is the developer platform for real-time world models: stream live, steerable AI video over WebRTC from JavaScript, React, Python, C++, Swift, Java, or Android. Multiple hosted models, one wire protocol — the full catalog is at /model-api-reference/overview.","colors":{"primary":"#555240","light":"#C7C099","dark":"#555240"},"logo":{"light":"https://mintcdn.com/reactortechnologiesinc/EHW3-v70m_GMPoy0/reactor-logo-dark.svg?fit=max\u0026auto=format\u0026n=EHW3-v70m_GMPoy0\u0026q=85\u0026s=aff8b9774a22c0da3d19597e4182f1d1","dark":"https://mintcdn.com/reactortechnologiesinc/EHW3-v70m_GMPoy0/reactor-logo-white.svg?fit=max\u0026auto=format\u0026n=EHW3-v70m_GMPoy0\u0026q=85\u0026s=c49b64bbeb9c22589b1d07f0794534a7"},"favicon":"https://mintcdn.com/reactortechnologiesinc/5kBYC6Bj7pWy1ZwU/reactor.jpg?fit=max\u0026auto=format\u0026n=5kBYC6Bj7pWy1ZwU\u0026q=85\u0026s=25e2b6e08774089fa699de5b183081eb","api":{"openapi":"openapi.yaml"},"background":{"decoration":"gradient","color":{"light":"#F5F4F0","dark":"#0A0A08"}},"navbar":{"links":[{"icon":"github","href":"https://github.com/reactor-team","label":"GitHub"}],"primary":{"type":"button","label":"Dashboard","href":"https://reactor.inc/dashboard"}},"seo":{"metatags":{"charset":"UTF-8","viewport":"width=device-width, initial-scale=1.0","description":"Reactor is the developer platform for real-time world models. Stream live AI-generated video at 30–60 FPS with JavaScript, Python, C++, Swift, Java, and Android SDKs.","keywords":"real-time video generation, world models, AI video streaming, Reactor SDK, Helios model, diffusion transformer, interactive video, image-to-video, JavaScript SDK, Python SDK, Java SDK, WebRTC, live AI video, create-reactor-app, npx create-reactor-app, scaffold, starter template, CLI, quickstart, create app","author":"Reactor","robots":"index, follow","googlebot":"index, follow","generator":"Mintlify","language":"en","theme-color":"#0A0A08","color-scheme":"light dark","category":"Technology","distribution":"global","coverage":"Worldwide","rating":"general","revisit-after":"3 days","referrer":"origin","HandheldFriendly":"True","MobileOptimized":"320","apple-mobile-web-app-capable":"yes","apple-mobile-web-app-status-bar-style":"black","apple-mobile-web-app-title":"Reactor Docs","application-name":"Reactor Docs","msapplication-TileColor":"#0A0A08","og:type":"website","og:image":"https://docs.reactor.inc/og-image.png","og:site_name":"Reactor Docs","og:locale":"en_US","twitter:card":"summary_large_image","twitter:site":"@reactorworld","twitter:image":"https://docs.reactor.inc/og-image.png","twitter:image:alt":"Reactor logo"},"indexing":"navigable"},"fonts":{"heading":{"family":"Aeonik","weight":700,"source":"fonts/aeonik/aeonik-bold.woff2","format":"woff2"},"body":{"family":"Aeonik","weight":400,"source":"fonts/aeonik/aeonik-regular.woff2","format":"woff2"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"github-dark-high-contrast"}},"latex":true},"banner":{"content":"**Private beta** · Reactor Serve is available by invitation. [Request access](mailto:team@reactor.inc)","dismissible":false,"color":{"light":"#555240","dark":"#302F27"}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","add-mcp","cursor","vscode"],"display":"header"},"markdown":{"instructions":["To build and serve your own model, start at /deploy/development/quickstart and /deploy/development/overview. Deploying is the default path: reactor init scaffolds a workspace, reactor auth login authenticates, and reactor model deploy registers the model, publishes the release with the weights/ folder, and activates it on Reactor's GPUs, in one command from that workspace. Docker must be running, because the publish step builds the image locally. Bump model.version in reactor.yaml before redeploying a change, because a release that already has an image is reactivated as it is. Deployment access is granted per account, so contact team@reactor.inc if a deploy is refused. Every key in reactor.yaml is documented at /deploy/platform/reactor-yaml. Model code imports reactor_runtime; Python client code imports reactor_sdk. The runtime overview explains the model interface. Running the model on your own machine with reactor run is optional and needs a GPU you attach with --gpus; /deploy/development/local-testing covers that loop and pairs a complete brightness model with a Python client test in a separate brightness-test workspace.","Reactor hosts multiple models, each with its own connect slug (modelName) and command/event schema. The video model catalog — slug, typed SDK package, and links to its schema — is at /model-api-reference/overview. Robotics policy documentation starts at /robotics/overview; The launch policies are Cosmos Nano DROID (/robotics/cosmos/nano-policy-droid/), DreamZero DROID (/robotics/dreamzero/droid/), and FLUX Action DROID (/robotics/flux-action/droid/), organized by model family and embodiment. Some models expose one slug per experience (e.g. HappyOyster); always take the slug from the model's own pages, never guess it.","Fastest path to a working app: `npx create-reactor-app my-app --model=\u003cslug>` scaffolds a complete app with secure auth wired up. Typed TypeScript SDKs are published as @reactor-models/\u003cmodel>; Python uses the base reactor-sdk package.","Auth: exchange an API key (rk_...) for a JWT via POST https://api.reactor.inc/tokens from your server. Never put the API key in client-side code.","Append .md to any docs URL for clean Markdown. Search these docs via the MCP server at https://docs.reactor.inc/mcp."]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"reactortechnologiesinc","hasAudioNarration":false,"actualSubdomain":"reactortechnologiesinc","customDomains":["docs.reactor.inc"],"gitSource":{"type":"github","owner":"reactor-team","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b008f35b72134c37c14298a","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Reference","count":190},{"language":"default","tag":"Endpoints","count":118},{"language":"default","tag":"Models","count":101},{"language":"default","tag":"Model APIs","count":93},{"language":"default","tag":"Serve Models","count":68},{"language":"default","tag":"Build a Model","count":51},{"language":"default","tag":"CLI Reference","count":41},{"language":"default","tag":"Robotics (Beta)","count":40},{"language":"default","tag":"Runtime Reference","count":39},{"language":"default","tag":"Policy inference","count":30}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"img[src*=\"reactor-logo\"],img[alt*=\"logo\"i],#navbar img,nav img,header img[src$=\".svg\"],a[href=\"/\"] img{max-height:20px!important;height:20px!important;width:auto!important}@font-face{font-family:'Aeonik';src:url('/fonts/aeonik/aeonik-medium.woff2') format('woff2'),\n url('/fonts/aeonik/aeonik-medium.woff') format('woff');font-weight:500;font-style:normal;font-display:swap}@font-face{font-family:'Aeonik';src:url('/fonts/aeonik/aeonik-regularitalic.woff2') format('woff2'),\n url('/fonts/aeonik/aeonik-regularitalic.woff') format('woff');font-weight:400;font-style:italic;font-display:swap}@font-face{font-family:'Aeonik';src:url('/fonts/aeonik/aeonik-mediumitalic.woff2') format('woff2'),\n url('/fonts/aeonik/aeonik-mediumitalic.woff') format('woff');font-weight:500;font-style:italic;font-display:swap}@font-face{font-family:'Aeonik';src:url('/fonts/aeonik/aeonik-bolditalic.woff2') format('woff2'),\n url('/fonts/aeonik/aeonik-bolditalic.woff') format('woff');font-weight:700;font-style:italic;font-display:swap}@font-face{font-family:'IBM Plex Mono';src:url('/fonts/ibm-plex-mono/IBMPlexMono-Regular.ttf') format('truetype');font-weight:400;font-style:normal;font-display:swap}code,pre,code *,pre *{font-family:'IBM Plex Mono', ui-monospace, monospace!important}a[href*=\"mintlify.com\"],a[href*=\"mintlify.com\"] *{display:none!important}.rea-stats{display:flex;flex-wrap:wrap;gap:clamp(1.75rem, 6vw, 4.5rem);margin:2rem 0 2.5rem;padding:1.5rem 0;border-top:1px solid color-mix(in srgb, #555240 22%, transparent);border-bottom:1px solid color-mix(in srgb, #555240 22%, transparent)}.dark .rea-stats{border-top-color:color-mix(in srgb, #C7C099 22%, transparent);border-bottom-color:color-mix(in srgb, #C7C099 22%, transparent)}.rea-stat{display:flex;flex-direction:column;gap:0.4rem}.rea-stat-value{font-family:'Aeonik', ui-sans-serif, sans-serif;font-weight:700;font-size:clamp(2.25rem, 5vw, 3.25rem);line-height:1;letter-spacing:-0.02em;color:#555240}.dark .rea-stat-value{color:#C7C099}.rea-stat-label{font-size:0.8125rem;font-weight:500;line-height:1.3;text-transform:uppercase;letter-spacing:0.08em;max-width:13ch;color:color-mix(in srgb, #0A0A08 58%, #F5F4F0)}.dark .rea-stat-label{color:color-mix(in srgb, #F5F4F0 62%, #0A0A08)}.rea-example{border-left:3px solid;padding:0.15rem 0 0.15rem 1rem;margin:1.25rem 0}.rea-example-dont{border-color:#e5484d}.dark .rea-example-dont{border-color:#ff6e6a}.rea-example-do{border-color:#30a46c}.dark .rea-example-do{border-color:#4ed99b}.rea-example::before{display:block;font-family:'Aeonik', ui-sans-serif, sans-serif;font-size:0.72rem;font-weight:700;text-transform:uppercase;letter-spacing:0.08em;line-height:1;margin-bottom:0.5rem}.rea-example-dont::before{content:\"✗ Don't\";color:#c4373b}.dark .rea-example-dont::before{color:#ff9b98}.rea-example-do::before{content:\"✓ Do\";color:#1f8a5b}.dark .rea-example-do::before{color:#5ad99e}.rea-example>p:last-child{margin-bottom:0}#content-area a:has(>code){border-bottom:none}#content-area a>code{text-decoration:underline!important;text-decoration-color:rgb(var(--primary))!important;text-decoration-thickness:1px;text-underline-offset:3px}.dark #content-area a>code{text-decoration-color:rgb(var(--primary-light))!important}.sdk-media-tabs{--media-line: #d8d5ca;--media-accent: #555240;--media-muted: #77756b;margin:1.5rem 0 2rem;border:1px solid var(--media-line);border-radius:8px}.dark .sdk-media-tabs{--media-line: #3b3d33;--media-accent: #c7c099;--media-muted: #999c8e}.sdk-media-tabs .tab-container{margin:0}.sdk-media-tabs [role=\"tablist\"]{margin:0;padding:0 1.25rem;gap:1.5rem;border-bottom:1px solid var(--media-line)}.sdk-media-tabs [role=\"tab\"]{margin:0}.sdk-media-tabs [data-component-part=\"tab-button\"]{padding:0.85rem 0 0.7rem;margin:0 0 -1px;border:0;border-bottom:2px solid transparent;color:var(--media-muted);font-weight:500}.sdk-media-tabs [role=\"tab\"][aria-selected=\"true\"] [data-component-part=\"tab-button\"]{border-bottom-color:var(--media-accent);color:var(--media-accent);font-weight:600}.sdk-media-tabs [role=\"tab\"]:hover [data-component-part=\"tab-button\"]{color:var(--media-accent)}.sdk-media-tabs [role=\"tab\"]:focus-visible{outline:2px solid var(--media-accent);outline-offset:4px;border-radius:2px}.sdk-media-tabs [role=\"tabpanel\"]{padding:1.25rem}.sdk-media-tabs [role=\"tabpanel\"]>:last-child{margin-bottom:0}.sdk-media-tabs table{margin:1rem 0}.sdk-media-tabs th,.sdk-media-tabs td{padding:0.75rem 0.5rem;border-bottom:1px solid var(--media-line)}.sdk-media-tabs th{font-weight:500;color:var(--media-muted)}.sdk-media-tabs th:first-child,.sdk-media-tabs td:first-child{padding-left:0}.sdk-media-tabs th:last-child,.sdk-media-tabs td:last-child{padding-right:0}.sdk-media-tabs tbody tr:last-child td{border-bottom:0}@media (max-width: 640px){.sdk-media-tabs [role=\"tabpanel\"]{padding:0.875rem}.sdk-media-tabs [role=\"tablist\"]{padding:0 0.875rem}}html:not([data-current-path^=\"/deploy/\"]):not([data-current-path=\"/deploy\"]){--banner-height: 0px !important}@layer components{html:not([data-current-path^=\"/deploy/\"]):not([data-current-path=\"/deploy\"]) #banner{display:none!important}}html:not([data-current-path^=\"/deploy/\"]):not([data-current-path=\"/deploy\"]) #sidebar{top:0}html:not([data-current-path^=\"/deploy/\"]):not([data-current-path=\"/deploy\"]) #navbar-transition-maple{margin-top:0}html:not([data-current-path^=\"/deploy/\"]):not([data-current-path=\"/deploy\"]) #content-side-layout{top:6rem;height:calc(100vh - 6rem)}#banner{font-size:14px}:is(#sidebar,#mobile-nav) a[href^=\"/model-api-reference/\"]:is([href$=\"#generate-a-clip\"],[href$=\"#stream-realtime\"]) svg{display:none}#navigation-items>div:has(>.sidebar-group>li[id=\"/platform-api/introduction\"])+div{margin-top:0}#navigation-items>div:has(>.sidebar-group>li[id=\"/platform-api/introduction\"])+div>.sidebar-group-header{display:none}"}]}
{"page":{"pagePath":"robotics/cosmos/nano-policy-droid/troubleshooting","slug":"/robotics/cosmos/nano-policy-droid/troubleshooting","pageMetadata":{"title":"Cosmos Nano DROID troubleshooting","sidebarTitle":"Troubleshooting","description":"Diagnose missing action chunks, step acknowledgements, and observation mapping.","href":"/robotics/cosmos/nano-policy-droid/troubleshooting"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Diagnose missing action chunks, step acknowledgements, and observation mapping.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Symptom`}),_jsx(_components.th,{children:`Check`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Connection rejected or no capacity`}),_jsxs(_components.td,{children:[`Use `,_jsx(_components.code,{children:`https://api.reactor.inc`}),`, the correct model identifier, and an authorized key. Capacity errors can occur before inference; retry with backoff or contact Reactor.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`No first chunk`}),_jsxs(_components.td,{children:[`Wait for `,_jsx(_components.code,{children:`READY`}),` before publishing. All three named tracks must deliver frames, and `,_jsx(_components.code,{children:`proprio_json`}),` must parse as row lists.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`No next chunk`}),_jsxs(_components.td,{children:[`Report the last received `,_jsx(_components.code,{children:`step`}),` after execution. Repeating the same or an older `,_jsx(_components.code,{children:`step`}),` does not request another prediction.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`State ignored`}),_jsx(_components.td,{children:`Encode JSON as a string inside the named command payload. Check the 8,000-character limits and row widths.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Correct shape, wrong motion`}),_jsx(_components.td,{children:`Check camera identities, joint ordering/units, and absolute-target interpretation. Tensor shape does not prove embodiment compatibility.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Gripper moves the wrong way`}),_jsxs(_components.td,{children:[`DROID uses `,_jsx(_components.code,{children:`0`}),` open and `,_jsx(_components.code,{children:`1`}),` closed. Convert your driver’s units/polarity explicitly.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Values differ on identical inputs`}),_jsx(_components.td,{children:`Sampling is unseeded and video transport can change the received pixels; exact numerical equality is not a supported check.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Unexpected step after reset`}),_jsx(_components.td,{children:`Reset restarts the counter but preserves input fields. Use a new session when old acknowledgements or replies could be mistaken for new ones.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`reference-client-behavior`,children:`Reference-client behavior`}),`\n`,_jsxs(_components.p,{children:[`Keep the event loop responsive so camera publishing and message handling can continue. Start a fresh\nsession after an uncertain timeout; do not fabricate an acknowledgement to force progress. The\ndocumented endpoint supports reset as specified in the\n`,_jsx(_components.a,{href:`/robotics/cosmos/nano-policy-droid/reference#task-changes-and-reset`,children:`reference`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`report-a-problem`,children:`Report a problem`}),`\n`,_jsx(_components.p,{children:`Include the model identifier, SDK/client versions, session ID, timestamps, track names/shapes,\nproprioception dimensions, last received and acknowledged counters, and exact error text. Never\ninclude an API key. State whether the failure occurred during connection, first prediction, or\nsubsequent control steps.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark-high-contrast"}},"config":{},"pageMetadata":{"title":"Cosmos Nano DROID troubleshooting","sidebarTitle":"Troubleshooting","description":"Diagnose missing action chunks, step acknowledgements, and observation mapping.","href":"/robotics/cosmos/nano-policy-droid/troubleshooting"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Reference-client behavior","slug":"reference-client-behavior","depth":2,"children":[]},{"title":"Report a problem","slug":"report-a-problem","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/reactortechnologiesinc/24c92226d5c54dd2/model-reference-navigation.js"],"subdomain":"reactortechnologiesinc","siteName":"Reactor","title":"Cosmos Nano DROID troubleshooting - Reactor","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T04:55:31.503Z","originalFileLocation":"robotics/cosmos/nano-policy-droid/troubleshooting.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Diagnose missing action chunks, step acknowledgements, and observation mapping.\">\u003cmeta data-mint-head name=\"keywords\" content=\"real-time video generation, world models, AI video streaming, Reactor SDK, Helios model, diffusion transformer, interactive video, image-to-video, JavaScript SDK, Python SDK, Java SDK, WebRTC, live AI video, create-reactor-app, npx create-reactor-app, scaffold, starter template, CLI, quickstart, create app\">\u003cmeta data-mint-head name=\"application-name\" content=\"Reactor\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/reactortechnologiesinc/i9XLeULlkcPcbz5H/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/reactortechnologiesinc/i9XLeULlkcPcbz5H/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/reactortechnologiesinc/i9XLeULlkcPcbz5H/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/reactortechnologiesinc/i9XLeULlkcPcbz5H/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/reactortechnologiesinc/i9XLeULlkcPcbz5H/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/reactortechnologiesinc/i9XLeULlkcPcbz5H/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/reactortechnologiesinc/i9XLeULlkcPcbz5H/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/reactortechnologiesinc/i9XLeULlkcPcbz5H/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/reactortechnologiesinc/i9XLeULlkcPcbz5H/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Cosmos Nano DROID troubleshooting - Reactor\">\u003cmeta data-mint-head property=\"og:description\" content=\"Diagnose missing action chunks, step acknowledgements, and observation mapping.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Reactor Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.reactor.inc/robotics/cosmos/nano-policy-droid/troubleshooting\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.reactor.inc/og-image.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Cosmos Nano DROID troubleshooting - Reactor\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Diagnose missing action chunks, step acknowledgements, and observation mapping.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.reactor.inc/og-image.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/reactortechnologiesinc/i9XLeULlkcPcbz5H/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Reactor Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A0A08\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"charset\" content=\"UTF-8\">\u003cmeta data-mint-head name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\u003cmeta data-mint-head name=\"author\" content=\"Reactor\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#0A0A08\">\u003cmeta data-mint-head name=\"color-scheme\" content=\"light dark\">\u003cmeta data-mint-head name=\"category\" content=\"Technology\">\u003cmeta data-mint-head name=\"distribution\" content=\"global\">\u003cmeta data-mint-head name=\"coverage\" content=\"Worldwide\">\u003cmeta data-mint-head name=\"rating\" content=\"general\">\u003cmeta data-mint-head name=\"revisit-after\" content=\"3 days\">\u003cmeta data-mint-head name=\"referrer\" content=\"origin\">\u003cmeta data-mint-head name=\"HandheldFriendly\" content=\"True\">\u003cmeta data-mint-head name=\"MobileOptimized\" content=\"320\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-capable\" content=\"yes\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-status-bar-style\" content=\"black\">\u003cmeta data-mint-head name=\"application-name\" content=\"Reactor Docs\">\u003cmeta data-mint-head name=\"twitter:image:alt\" content=\"Reactor logo\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.reactor.inc/robotics/cosmos/nano-policy-droid/troubleshooting\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/robotics/cosmos/nano-policy-droid/troubleshooting.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.reactor.inc/#organization\",\"name\":\"Reactor\",\"url\":\"https://docs.reactor.inc\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/reactortechnologiesinc/EHW3-v70m_GMPoy0/reactor-logo-dark.svg?fit=max\u0026auto=format\u0026n=EHW3-v70m_GMPoy0\u0026q=85\u0026s=aff8b9774a22c0da3d19597e4182f1d1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.reactor.inc#website\",\"name\":\"Reactor\",\"url\":\"https://docs.reactor.inc\",\"publisher\":{\"@id\":\"https://docs.reactor.inc/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.reactor.inc/robotics/cosmos/nano-policy-droid/troubleshooting#webpage\",\"url\":\"https://docs.reactor.inc/robotics/cosmos/nano-policy-droid/troubleshooting\",\"name\":\"Cosmos Nano DROID troubleshooting\",\"description\":\"Diagnose missing action chunks, step acknowledgements, and observation mapping.\",\"dateModified\":\"2026-11-12T04:55:31.503Z\",\"isPartOf\":{\"@id\":\"https://docs.reactor.inc#website\"},\"breadcrumb\":{\"@id\":\"https://docs.reactor.inc/robotics/cosmos/nano-policy-droid/troubleshooting#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.reactor.inc/robotics/cosmos/nano-policy-droid/troubleshooting#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Policy inference\",\"item\":\"https://docs.reactor.inc/robotics/cosmos/nano-policy-droid/quickstart\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Cosmos Nano\",\"item\":\"https://docs.reactor.inc/robotics/cosmos/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"DROID\",\"item\":\"https://docs.reactor.inc/robotics/cosmos/nano-policy-droid/overview\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Cosmos Nano DROID troubleshooting\",\"item\":\"https://docs.reactor.inc/robotics/cosmos/nano-policy-droid/troubleshooting\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.reactor.inc/robotics/cosmos/nano-policy-droid/troubleshooting#article\",\"headline\":\"Cosmos Nano DROID troubleshooting\",\"name\":\"Cosmos Nano DROID troubleshooting\",\"description\":\"Diagnose missing action chunks, step acknowledgements, and observation mapping.\",\"url\":\"https://docs.reactor.inc/robotics/cosmos/nano-policy-droid/troubleshooting\",\"mainEntityOfPage\":{\"@id\":\"https://docs.reactor.inc/robotics/cosmos/nano-policy-droid/troubleshooting#webpage\"},\"image\":\"https://docs.reactor.inc/og-image.png\",\"dateModified\":\"2026-11-12T04:55:31.503Z\",\"publisher\":{\"@id\":\"https://docs.reactor.inc/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.reactor.inc#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Reactor\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Reactor\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/robotics/cosmos/nano-policy-droid/troubleshooting.md","siteName":"Reactor","nav":{"global":null,"tabs":[{"tab":"Build Apps","icon":"book-open","pages":[{"title":"Build Apps","href":"/overview"}]},{"tab":"Model APIs","icon":"box","pages":[{"title":"Model APIs","href":"/model-api-reference/overview"}]},{"tab":"Serve Models","icon":"server","pages":[{"title":"Serve Models","href":"/deploy/overview"}]},{"tab":"Robotics (Beta)","icon":"bot","groups":[{"group":"Get started","pages":[{"title":"Robotics (Beta)","href":"/robotics/overview"},{"title":"How the API works","href":"/robotics/how-the-api-works"}]},{"group":"Policy inference","pages":[{"group":"Cosmos Nano","root":{"title":"Cosmos Nano","href":"/robotics/cosmos/overview"},"pages":[{"group":"DROID","root":{"title":"Cosmos Nano DROID","sidebarTitle":"Overview","href":"/robotics/cosmos/nano-policy-droid/overview"},"pages":[{"title":"Get your first actions","href":"/robotics/cosmos/nano-policy-droid/quickstart"},{"title":"Run in simulation","href":"/robotics/cosmos/nano-policy-droid/simulation"},{"title":"Integration","href":"/robotics/cosmos/nano-policy-droid/integration"},{"title":"Cosmos Nano DROID reference","sidebarTitle":"Observations and actions","description":"Camera tracks, joint state, action formats, and requesting the next prediction.","href":"/robotics/cosmos/nano-policy-droid/reference"},{"title":"Cosmos Nano DROID troubleshooting","sidebarTitle":"Troubleshooting","href":"/robotics/cosmos/nano-policy-droid/troubleshooting"},{"title":"Release notes","description":"Supported Cosmos Nano DROID contract.","href":"/robotics/cosmos/nano-policy-droid/changelog"}]}]},{"group":"DreamZero","root":{"title":"DreamZero","sidebarTitle":"Overview \u0026 variants","href":"/robotics/dreamzero/overview"},"pages":[{"group":"DROID","root":{"title":"DreamZero DROID","sidebarTitle":"Overview","href":"/robotics/dreamzero/droid/overview"},"pages":[{"title":"Get your first DROID actions","href":"/robotics/dreamzero/droid/quickstart"},{"title":"Run DreamZero DROID in simulation","href":"/robotics/dreamzero/droid/simulation"},{"title":"Integration","href":"/robotics/dreamzero/droid/integration"},{"title":"DreamZero DROID reference","sidebarTitle":"Observations and actions","href":"/robotics/dreamzero/droid/reference"},{"title":"DreamZero DROID troubleshooting","href":"/robotics/dreamzero/droid/troubleshooting"},{"title":"Release notes","href":"/robotics/dreamzero/droid/changelog"}]}]},{"group":"FLUX Action","root":{"title":"FLUX Action","href":"/robotics/flux-action/overview"},"pages":[{"group":"DROID","root":{"title":"DROID variant","href":"/robotics/flux-action/droid/overview"},"pages":[{"title":"Get your first actions","href":"/robotics/flux-action/droid/quickstart"},{"title":"Build a simulator adapter","href":"/robotics/flux-action/droid/simulation"},{"title":"Integration","href":"/robotics/flux-action/droid/integration"},{"title":"Inputs and actions","href":"/robotics/flux-action/droid/reference"},{"title":"Troubleshooting","href":"/robotics/flux-action/droid/troubleshooting"},{"title":"Release notes","href":"/robotics/flux-action/droid/changelog"}]}]},{"group":"Praxis-1","root":{"title":"Praxis-1","href":"/robotics/praxis/overview"},"pages":[{"group":"DROID","root":{"title":"Praxis-1 DROID","sidebarTitle":"Overview","href":"/robotics/praxis/droid/overview"},"pages":[{"title":"Get your first actions","href":"/robotics/praxis/droid/quickstart"},{"title":"Build a simulator adapter","href":"/robotics/praxis/droid/simulation"},{"title":"Integration","href":"/robotics/praxis/droid/integration"},{"title":"Observations and actions","href":"/robotics/praxis/droid/reference"},{"title":"Troubleshooting","href":"/robotics/praxis/droid/troubleshooting"},{"title":"Release notes","href":"/robotics/praxis/droid/changelog"}]},{"group":"YAM","root":{"title":"Praxis-1 YAM","sidebarTitle":"Overview","href":"/robotics/praxis/yam/overview"},"pages":[{"title":"Get your first actions","href":"/robotics/praxis/yam/quickstart"},{"title":"Build a simulator adapter","href":"/robotics/praxis/yam/simulation"},{"title":"Integration","href":"/robotics/praxis/yam/integration"},{"title":"Observations and actions","href":"/robotics/praxis/yam/reference"},{"title":"Troubleshooting","href":"/robotics/praxis/yam/troubleshooting"},{"title":"Release notes","href":"/robotics/praxis/yam/changelog"}]}]}]},{"group":"Simulation","pages":[{"title":"Simulation for robotics","sidebarTitle":"Overview","href":"/robotics/simulation-and-synthetic-data"},{"group":"Cosmos3 Nano Sim Bimanual","pages":[{"title":"Cosmos3 Nano Sim Bimanual","href":"/robotics/cosmos/nano-sim-bimanual/overview"},{"title":"AgiBot inputs and controls","href":"/robotics/cosmos/nano-sim-bimanual/agibot/overview"},{"title":"Build an AgiBot simulation","href":"/robotics/cosmos/nano-sim-bimanual/agibot/interactive-controls"}]},{"group":"Cosmos3 Nano Sim Transfer","pages":[{"title":"Cosmos3 Nano Sim Transfer","href":"/robotics/cosmos/nano-sim-transfer/overview"},{"title":"Render a depth sequence","href":"/robotics/cosmos/nano-sim-transfer/render-a-sequence"},{"title":"Connect to a simulator","href":"/robotics/cosmos/nano-sim-transfer/connect-a-simulator"},{"title":"Generate appearance variants","href":"/robotics/cosmos/nano-sim-transfer/appearance-variants"}]}]}]},{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":"/deploy/development/robotics/rldx-1"}]},{"tab":"Reference","icon":"book-open","pages":[{"title":"Reference","href":"/reference/introduction"}]},{"tab":"Release Notes","icon":"clock","pages":[{"title":"Release Notes","href":"/changelog/overview"}]}]},"basePath":"","title":"Cosmos Nano DROID troubleshooting - Reactor","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["10e4515597"],"chunks":["BannerMarkdown-BOAJk9BH.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}