What is this?
A cookbook of small, runnable example programs for Solari, a service that gives you cloud browsers, sandboxes, and desktop VMs behind a single API key.
A cookbook of small, runnable example programs for Solari, a service that gives you cloud browsers, sandboxes, and desktop VMs behind a single API key.Is this a library, or just a bunch of example scripts?It is a collection of standalone example scripts, one idea per file, meant to be copied into your own project rather than imported as a package; each example calls the real Solari API directly.
It is a collection of standalone example scripts, one idea per file, meant to be copied into your own project rather than imported as a package; each example calls the real Solari API directly.How do I run one of the examples?Each example directory is self-contained: open the one you want (e.g. browser-quickstart-py or sandbox-quickstart-ts) and run it with a Solari API key; one key works across browsers, sandboxes, and desktops.
Each example directory is self-contained: open the one you want (e.g. browser-quickstart-py or sandbox-quickstart-ts) and run it with a Solari API key; one key works across browsers, sandboxes, and desktops.Which languages are the examples written in, and do I need an API key?Examples are written in TypeScript, Python, and Ruby (one uses only the Ruby standard library, no SDK). You need a Solari API key to run any of them.
Examples are written in TypeScript, Python, and Ruby (one uses only the Ruby standard library, no SDK). You need a Solari API key to run any of them.What are the gotchas if I copy these examples into my own code?A browser profile only restores cookies, not localStorage, unless you pass storageState into newContext(); sandbox commands are not shell-interpreted, so run('ls -la') looks for a literal binary by that name; session recordings upload asynchronously, so the replay endpoint 404s for up to ~30s after you stop; and the TypeScript SDK cannot run on edge runtimes like Cloudflare Workers because it bundles a Playwright fork needing Node.
A browser profile only restores cookies, not localStorage, unless you pass storageState into newContext(); sandbox commands are not shell-interpreted, so run('ls -la') looks for a literal binary by that name; session recordings upload asynchronously, so the replay endpoint 404s for up to ~30s after you stop; and the TypeScript SDK cannot run on edge runtimes like Cloudflare Workers because it bundles a Playwright fork needing Node.Should I use the cloud browser, the sandbox, or the desktop product?Use the cloud browser for anything you'd do with Playwright or Puppeteer on a webpage, plus stealth and managed proxies; use the sandbox when you need to run code like an LLM's Python or an untrusted build in a microVM that boots from a snapshot in about a second; use the desktop when you need a clickable screen, e.g. for computer-use agents or GUI apps.
Use the cloud browser for anything you'd do with Playwright or Puppeteer on a webpage, plus stealth and managed proxies; use the sandbox when you need to run code like an LLM's Python or an untrusted build in a microVM that boots from a snapshot in about a second; use the desktop when you need a clickable screen, e.g. for computer-use agents or GUI apps.What is the 'applications' folder for?It holds bigger programs built on Solari — full CLIs or UIs with their own modules that solve a whole problem, as opposed to the single-idea examples in the main folders.
It holds bigger programs built on Solari — full CLIs or UIs with their own modules that solve a whole problem, as opposed to the single-idea examples in the main folders.Can I run my existing Playwright test suite against Solari?Yes — browser-playwright-runner-ts shows connecting your suite to Solari's session CDP endpoint instead of a local Chromium, which also sidesteps Playwright's version-gated wire protocol.
Yes — browser-playwright-runner-ts shows connecting your suite to Solari's session CDP endpoint instead of a local Chromium, which also sidesteps Playwright's version-gated wire protocol.What does the sandbox snapshot/fork example show?sandbox-snapshot-fork-py seeds a snapshot once, forks multiple clones from it, and verifies each clone restored the exact same file digest, useful for fast, reproducible agent environments.
sandbox-snapshot-fork-py seeds a snapshot once, forks multiple clones from it, and verifies each clone restored the exact same file digest, useful for fast, reproducible agent environments.Does closing the browser in TypeScript hang my script?Not since @solarisdk/browser 0.1.3 — browser.close() alone now exits cleanly; before that version you also had to call solari.close() or the script would hang on an open loopback listener.
Not since @solarisdk/browser 0.1.3 — browser.close() alone now exits cleanly; before that version you also had to call solari.close() or the script would hang on an open loopback listener.What are similar projects?browser-use, camofox-browser, web-ui, OpenSandbox, moli, figranium, invisible_puppeteer, patchright-enhanced
browser-use, camofox-browser, web-ui, OpenSandbox, moli, figranium, invisible_puppeteer, patchright-enhancedWhich topics is it in?cookbook, snapshot, cloud-browser, microvm, stealth, headless-browser, screen-recording, vnc, gui-automation, x11, captcha, scraping
cookbook, snapshot, cloud-browser, microvm, stealth, headless-browser, screen-recording, vnc, gui-automation, x11, captcha, scraping