Quickstart
O Rookbox fala o protocolo da E2B. Você usa o SDK da E2B sem alterações e aponta para a API do Rookbox.
-
Pegue uma chave. O Rookbox está em beta fechado: entre na lista de espera em rookbox.run. Com o convite, abra o Painel, vá em Chaves de API e crie uma. A chave começa com
rbx_e aparece uma única vez. Copie na hora. -
Instale o SDK.
Janela do terminal pip install e2bJanela do terminal npm i e2b -
Configure duas variáveis.
Janela do terminal export E2B_API_KEY=rbx_...export E2B_API_URL=https://api.rookbox.run -
Crie uma máquina e rode um comando.
from e2b import Sandboxsandbox = Sandbox.create(timeout=15 * 60) # 15 minutosprint(sandbox.commands.run("uname -a").stdout)import { Sandbox } from "e2b";const sandbox = await Sandbox.create({ timeoutMs: 15 * 60_000 }); // 15 minutosconst result = await sandbox.commands.run("uname -a");console.log(result.stdout); -
Exponha uma porta.
sandbox.commands.run("python3 -m http.server 8000", background=True)print(sandbox.get_host(8000)) # 8000-<id>.box.rookbox.runawait sandbox.commands.run("python3 -m http.server 8000", { background: true });console.log(sandbox.getHost(8000)); // 8000-<id>.box.rookbox.runO endereço exige um token de tráfego. Veja Portas e URLs.
-
Suspenda e retome. No SDK da E2B,
pauseé osuspenddo Rookbox: a memória fica guardada.sandbox_id = sandbox.sandbox_idsandbox.beta_pause() # suspende, memória guardadasandbox = Sandbox.connect(sandbox_id) # retoma, cerca de 1 sconst id = sandbox.sandboxId;await sandbox.betaPause(); // suspende, memória guardadaconst back = await Sandbox.connect(id); // retoma, cerca de 1 sNas versões atuais do SDK o método se chama
beta_pause(Python) ebetaPause(TypeScript). -
Remova.
sandbox.kill()await sandbox.kill();
Próximos passos
Seção intitulada “Próximos passos”- CLI: o mesmo fluxo no terminal.
- Ciclo de vida: prazo, suspensão e remoção.
- Limites: máquinas por conta e o que fazer no 429 e no 503.