Introduction

RuntimeUse is an open-source runtime and client library for running AI agents inside isolated sandboxes and controlling them from Python over WebSocket.

Quickstart

See how to integrate with popular sandbox providers.

• Your agent needs filesystem, CLI, or network access inside an isolated runtime.
• Your application should stay outside the sandbox while still controlling the run.
• You don't want to build infrastructure for interacting with your agent in sandbox.

• Task invocations: send a prompt to any agent runtime and receive a result over WebSocket as text or typed JSON.
• Pre-agent downloadables: fetch code, repos, or data into the sandbox before the run starts.
• Pre-commands: run bash commands before the agent starts executing.
• Artifact uploads: move generated files out of the sandbox with a presigned URL handshake.
• Streaming and cancellation: receive progress updates and stop runs cleanly.
• Secret-aware execution: redact sensitive values before they leave the sandbox.
• Persistent sessions: run many sequential invocations and commands over a single WebSocket connection.