Skip to main content
Accessed via sandbox.pty.

await sandbox.pty.create(cols=80, rows=24, on_output=None)

Create an interactive terminal session. HTTP API →
cols
int
default:"80"
Terminal columns
rows
int
default:"24"
Terminal rows
on_output
Callable[[bytes], None]
Output callback
Returns: PtySession

PtySession

MemberTypeDescription
session_idstrSession ID
sandbox_idstrSandbox ID
send(data)methodSend input (str or bytes)
await recv()methodReceive output bytes (Python-unique)
await close()methodClose the PTY
recv() is Python-unique — a pull-based alternative to the on_output callback. Returns raw bytes.