Guías¶

Una página por función. Cada guía empieza con un ejemplo corto en Python, Python async y TypeScript (las pestañas se sincronizan: elige tu lenguaje una vez), explica las opciones y termina con los errores habituales y las diferencias con E2B.

Sandbox¶

Guía	Para qué
Ciclo de vida	crear, conectar, listar, inspeccionar y destruir sandboxes; plantillas y metadatos
Pausar y reanudar	congelar un sandbox con todo su estado y despertarlo; la auto-suspensión por inactividad
Plazo del servidor	un plazo que el sandbox cumple aunque tu proceso muera; `set_timeout()`
Pool	sandboxes listos en menos de un segundo
Persistencia	el `HOME` en S3, más allá de las 8 h
Async	`AsyncSandbox` en Python y las equivalencias en TypeScript

Ejecutar¶

Guía	Para qué
Comandos	procesos en primer y segundo plano, `stdin`, señales y reconexión
Ejecutar código	celdas de Python con estado, resultados, gráficos, errores y contextos
Lenguajes y kernels	bash, JavaScript y TypeScript con Deno
Terminal (PTY)	una terminal interactiva real

Ficheros y red¶

Guía	Para qué
Ficheros y S3	leer, escribir, listar, vigilar; ficheros grandes y URLs firmadas
Red saliente	cortar o filtrar la salida a internet
Puertos y host	llegar por HTTP a un servidor que corre en el sandbox

Observar y herramientas¶

Guía	Para qué
Métricas y listado	CPU, memoria y disco; historial; listado paginado
Git	clonar, hacer commit y push desde el sandbox

Agentes¶

Guía	Para qué
Servidor MCP	un sandbox para Claude Code, Claude Desktop, Cursor o VS Code
LangChain y Vercel AI	Rayito como herramienta de un agente
Agente en el sandbox	un agente de código (OpenCode o deepagents) dentro del sandbox con `sbx.agent.run()`, el modelo tras la pasarela de secretos; el arranque rápido, opcional

Desarrollar y probar¶

Guía	Para qué
Probar en local (Docker + Floci)	correr los SDK contra un `rayd` real y un AWS emulado, sin cuenta ni coste

Las funciones que tienen coste propio en AWS y están apagadas por defecto (secretos, pasarela de secretos, montajes S3, tamaños, eventos y webhooks, exportación OTLP, OpenTelemetry, índice de metadatos, templates y templates de agente, pilas opcionales, volúmenes EFS y dominio propio, estos dos experimentales) o que son sólo de la CLI (proxy local) están en Funciones opcionales. Lo nuevo de cada versión: Novedades.