Human tools

# pip install boxlite
import asyncio
import boxlite

async def main():
    # ComputerBox ships with an XFCE desktop plus a noVNC web client.
    # gui_http_port / gui_https_port map "host local ports" -> in-sandbox GUI ports.
    try:
        async with boxlite.ComputerBox(
            cpu=2,
            memory=2048,
            gui_http_port=3000,   # host http port; open it in a browser
            gui_https_port=3001,  # host https port (self-signed cert; browser warns)
        ) as desktop:
            # Wait until the desktop environment is fully up (default max 60s)
            await desktop.wait_until_ready(timeout=60)

            print("Desktop ready. Open either URL below in a browser to take over:")
            print("  HTTP :  http://localhost:3000")
            print("  HTTPS:  https://localhost:3001  (self-signed cert; click 'Advanced' -> 'Proceed')")

            # Keep the sandbox alive to give the human time to operate.
            # On async with exit the sandbox is destroyed and all changes are lost (ephemeral).
            input("When done, come back here and press Enter to close the sandbox...")
    except RuntimeError as exc:
        # Image pull failure / no hardware virtualization, etc. all raise standard RuntimeError
        print(f"Sandbox failed to start: {exc}")

if __name__ == "__main__":
    asyncio.run(main())

# pip install boxlite
# Requires a Claude OAuth token: env var CLAUDE_CODE_OAUTH_TOKEN or the oauth_token constructor argument
import asyncio
import boxlite

async def main():
    try:
        async with boxlite.SkillBox(
            skills=["anthropics/skills"],
            # oauth_token="<YOUR_CLAUDE_CODE_OAUTH_TOKEN>",  # the env var also works
        ) as box:
            await box.wait_until_ready(timeout=60)

            # Ports are randomly assigned; read the real value from the instance attribute
            print("Open the URL below in a browser to watch Claude work in real time:")
            print(f"  HTTP :  http://localhost:{box.gui_http_port}")
            print(f"  HTTPS:  https://localhost:{box.gui_https_port}")

            # Assign a task to Claude; call() returns its answer (the human can watch its actions live in the browser)
            answer = await box.call("List your currently available skills")
            print(answer)
    except ValueError as exc:
        # When the OAuth token is missing, __aenter__ raises ValueError
        print(f"SkillBox configuration missing: {exc}")
    except RuntimeError as exc:
        print(f"Sandbox failed to start: {exc}")

if __name__ == "__main__":
    asyncio.run(main())

# pip install boxlite
import asyncio
import boxlite

async def main():
    try:
        # Browser type and other config are passed via BrowserBoxOptions (not constructor keywords)
        async with boxlite.BrowserBox(
            boxlite.BrowserBoxOptions(browser="chromium")
        ) as browser:
            # CDP direct-connect endpoint: paste into Chrome DevTools remote debugging to view pages and tune selectors.
            # Note: endpoint() and playwright_endpoint() are mutually exclusive; an instance can use only one.
            # Calling the other after one has been used raises RuntimeError.
            cdp_endpoint = await browser.endpoint(timeout=60)
            print(f"CDP endpoint (paste into Chrome DevTools remote debugging): {cdp_endpoint}")

            input("When done debugging, press Enter to close the sandbox...")
    except ValueError as exc:
        # browser="webkit" does not support endpoint() (CDP mode); use playwright_endpoint() instead
        print(f"This browser does not support CDP direct connect: {exc}")
    except RuntimeError as exc:
        print(f"Sandbox failed to start: {exc}")

if __name__ == "__main__":
    asyncio.run(main())