Share a desktop with a person in a browser

# desktop_share.py — start an isolated desktop accessible from a human's browser
# Run: python desktop_share.py
import asyncio

import boxlite  # pip install boxlite (latest published version)

async def main() -> None:
    # gui_http_port / gui_https_port are ports on the "host".
    # Fix them so others get a stable address.
    try:
        async with boxlite.ComputerBox(
            cpu=2,
            memory=2048,
            gui_http_port=3000,   # host HTTP port (noVNC web desktop)
            gui_https_port=3001,  # host HTTPS port (self-signed cert)
        ) as desktop:
            # Wait until the desktop environment is fully ready (default timeout 60s)
            await desktop.wait_until_ready(timeout=60)

            print("Desktop ready. Send the addresses below to whoever needs access:")
            print("  HTTP : http://localhost:3000")
            print("  HTTPS: https://localhost:3001  (browser warns about the self-signed cert; click 'Advanced' -> 'Proceed')")
            print("Press Ctrl+C to stop and destroy this ephemeral desktop.")

            # Keep the box alive until you stop it manually.
            while True:
                await asyncio.sleep(3600)
    except KeyboardInterrupt:
        print("\nStopped; desktop box destroyed.")
    except RuntimeError as exc:
        # Image pull failure / no virtualization, etc. all raise standard RuntimeError
        print(f"Failed to start: {exc}")

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

// desktop_share.ts — Run: node desktop_share.js (compile first, or use a ts runner)
import { ComputerBox } from "@boxlite-ai/boxlite";

async function main(): Promise<void> {
  try {
    await using desktop = new ComputerBox({
      cpus: 2,
      memoryMib: 2048,
      guiHttpPort: 3000,   // host HTTP port
      guiHttpsPort: 3001,  // host HTTPS port
    });
    await desktop.waitUntilReady(60);

    console.log("Desktop ready: http://localhost:3000 (or https://localhost:3001)");
    console.log("Press Ctrl+C to stop.");
    await new Promise(() => {}); // keep alive
  } catch (err) {
    // Missing command / pull failure / no virtualization raise a standard Error
    console.error("Failed to start:", err);
  }
}

main();

import boxlite

async def share_with_mount() -> None:
    # The third element must be a bool; True for read-only, False for read-write (or omit and use a 2-tuple)
    async with boxlite.ComputerBox(
        gui_http_port=3000,
        volumes=[("/host/data", "/mnt/data", True)],  # bool; passing "ro" raises TypeError
    ) as desktop:
        await desktop.wait_until_ready()