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.

When to use

• 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.

What it handles

• 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.