Sandboxes

Create a sandbox

A sandbox is a container you drive from your code: useful for running code an LLM wrote or a player uploaded, apart from everything else. Every customer's work runs sandboxed, apart from other customers and from the machine.

from klio_compute import Sandbox, Image

sandbox = Sandbox(cpu=1, memory="1Gi", image=Image(python_version="python3.12")).create()
try:
    result = sandbox.process.run_code("print(2 + 2)")
    print(result.result)
finally:
    sandbox.terminate()

sandbox.process.exec(...) runs a command, and sandbox.fs uploads and downloads files. A sandbox can have a GPU with gpu=. You pay for the seconds it runs; terminate() stops it.

With the Modal-compatible API

import klio_compute.compat as modal

sandbox = modal.Sandbox.create(image=modal.Image.debian_slim(), timeout=300)
process = sandbox.exec("bash", "-c", "echo hello")
print(process.stdout.read())
sandbox.terminate()

Sandbox.create, exec, filesystem.write_text, filesystem.read_text and terminate work. Options that can't be honored stop with a clear message.