tinker_cookbook.sandbox.ModalSandbox

class tinker_cookbook.sandbox.ModalSandbox()

Persistent Modal sandbox for code execution. Conforms to SandboxInterface.

Usage: sandbox = await ModalSandbox.create()

await sandbox.write_file("/workspace/code.py", "print('hello')") result = await sandbox.run_command("python /workspace/code.py") print(result.stdout)

await sandbox.cleanup()

create( app_name, timeout, image, max_stream_output_bytes)

Create a new Modal sandbox.

Parameters:

• app_name ( str)
• timeout ( int)
• image ( modal.Image | None)
• max_stream_output_bytes ( int)

Returns: ModalSandbox

run_command( command, workdir, timeout, max_output_bytes)

Run a shell command in the sandbox.

Parameters:

• command ( str)
• workdir ( str | None)
• timeout ( int)
• max_output_bytes ( int | None)

Returns: SandboxResult

read_file( path, max_bytes, timeout)

Read a file from the sandbox.

Parameters:

• path ( str)
• max_bytes ( int | None)
• timeout ( int)

Returns: SandboxResult

write_file( path, content, executable, timeout)

Write content to a file in the sandbox.

Parameters:

• path ( str)
• content ( str | bytes)
• executable ( bool)
• timeout ( int)

Returns: SandboxResult

cleanup()

Terminate the Modal sandbox and wait for it to fully shut down.

Returns: None