Pular para o conteúdo

Quickstart

O Rookbox fala o protocolo da E2B. Você usa o SDK da E2B sem alterações e aponta para a API do Rookbox.

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

  2. Instale o SDK.

    Janela do terminal
    pip install e2b
  3. Configure duas variáveis.

    Janela do terminal
    export E2B_API_KEY=rbx_...
    export E2B_API_URL=https://api.rookbox.run
  4. Crie uma máquina e rode um comando.

    from e2b import Sandbox
    sandbox = Sandbox.create(timeout=15 * 60) # 15 minutos
    print(sandbox.commands.run("uname -a").stdout)
  5. Exponha uma porta.

    sandbox.commands.run("python3 -m http.server 8000", background=True)
    print(sandbox.get_host(8000)) # 8000-<id>.box.rookbox.run

    O endereço exige um token de tráfego. Veja Portas e URLs.

  6. Suspenda e retome. No SDK da E2B, pause é o suspend do Rookbox: a memória fica guardada.

    sandbox_id = sandbox.sandbox_id
    sandbox.beta_pause() # suspende, memória guardada
    sandbox = Sandbox.connect(sandbox_id) # retoma, cerca de 1 s

    Nas versões atuais do SDK o método se chama beta_pause (Python) e betaPause (TypeScript).

  7. Remova.

    sandbox.kill()
  • 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.