ReferenceSDK

Limits and workarounds

Limits that apply to every Nevia SDK in early access, and where to find each adapter's own limits

These limits apply to all four SDKs. Most come from the API the SDKs call, so they also apply to the CLI and MCP. Each adapter has further limits, listed on its own page.

Exec

  • About 50 seconds per command through the API. Exec runs through the API by default, which ends a request after about 50 seconds. Use direct exec for longer commands. It sends the command straight to the computer. Each SDK page shows how to turn it on.
  • About 700 KB of output through the API. The API returns the whole output in one answer, capped at 1 MiB, so output above about 700 KB can fail. Direct exec keeps the last 64 KiB of each stream instead and marks the result truncated. For large output, write it to a file on the computer and read it with the files methods.
  • Background children keep exec open. Exec returns when the command's output streams close, not when the command exits. A command that starts a background job must redirect that job's output, for example server > /tmp/server.log 2>&1 &.
  • A timeout ends a few seconds late. The SDK stops a timed-out command with TERM, then KILL five seconds later. Allow a few seconds beyond the timeout.
  • No reattach. Once a call ends, there is no way to reconnect to a command that is still running. Cancelling or interrupting the call does not stop the command on the computer.
  • Commands run as the image's user. On most public images that is root.

Files

  • Files go through exec. The files methods read and write in chunks over exec, so a large file takes many requests. Moving 100 MB takes hundreds of requests.
  • Only some paths survive a branch. Files outside the persistent disk are not copied to a branch. Computer lifecycle states says what persists.

Computers

  • A checkpoint needs its source computer. Deleting a computer also deletes its checkpoints. Keep the source computer for as long as you need them.
  • No restart. The current build has no restart. A restart call answers not_supported.
  • Reserved environment names. The API refuses environment variable names that start with NEVIA_.

Errors

  • New error codes can appear. Treat a code you don't recognise as a generic failure. A capability the computer doesn't have answers not_supported.

Adapters

Each adapter page lists its own limitations: LangGraph, Pydantic AI, Agno, Mastra, Eve, Flue, Rig and Alloy.

On this page