glovebox-driver

The host-side Python that drives one glovebox microVM: boot it, run commands in it, read what it let out, and tear it down. It imports no eval framework, so an integration picks the framework and this package holds the VM.

inspect-glovebox and shepherd-glovebox are both built on it.

What the host needs

The driver runs the glovebox command, which drives Docker's sbx sandbox runtime. Install glovebox and sign in to sbx, then ask whether this host qualifies:

glovebox sandbox preflight

Set GLOVEBOX_BIN when the executable is not on PATH.

The modules

Boot one

import os
from pathlib import Path

from glovebox_driver import cli
from glovebox_driver.session import GloveboxSession

workspace = Path("/path/to/workspace")
workspace.mkdir(parents=True, exist_ok=True)
os.chmod(workspace, 0o755)
ready_path = workspace / ".ready"
ready_path.touch()

cli.preflight()
session = GloveboxSession.boot(str(workspace), str(ready_path), boot_timeout=300)
try:
    ...
finally:
    session.teardown()

boot waits for ready_path to exist; it never creates it. Every in-tree caller touches its own marker first, and the guest user needs permission to traverse the workspace, so a freshly created directory needs its mode set too.

Apache-2.0.