DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

zzzgydi /

zzzgydi/verge-browser

Topic repository only

Self-hosted browser sandbox for AI agents. Chromium, CDP, Playwright, noVNC/Xpra, persistent sessions & human takeover.

★ 27 Stars3 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@97706906

Verge Browser — An open-source browser sandbox built for agents. See it live. Take over anytime.

Deploy it on your own server.
Watch your agent browse the web in real time, right from your browser.
When it reaches a login screen or gets stuck, pause automation and step in.

Deploy to a server →  Usage  Development  中文


Features

  • Self-hosted browser: run GUI Chromium in Docker on a Linux server, independently of your personal computer.
  • Agent automation: connect through CDP with Playwright or Puppeteer, or use the SDK, CLI, and REST API.
  • Live view and manual control: view the browser through noVNC or Xpra; pause automation before taking over.
  • Persistent workspaces: each sandbox has its own browser profile and shared files, preserved across pause and resume.
  • Remote access: use compatible mobile or cloud agents when the service is reachable. See access requirements.
Dashboard preview
Verge Browser dashboard showing sandbox status, a screenshot preview, and session and CDP controls

Getting Started

Requires a Linux Docker host with Docker Compose. The host does not need a desktop environment.

  1. Set up the service using the server deployment guide, or follow the local Docker setup.
  2. Open /admin at your service address and sign in with the configured admin token.
  3. Create a sandbox, open its visual session, or connect your agent using the usage guide.

The current deployment model targets a single node in a trusted environment. See compatibility and limits for isolation and persistence boundaries.

Documentation

Topic Guides
Deployment Docker setup, Linux server, environment variables
Usage Usage guide, human handoff, persistent profiles
Clients & API SDK & CLI, API reference
Integrations Codex, Playwright MCP, DeepSeek Harness preview plugin
Agent Skills Deployment skill, usage skill

Development & Contributing

The project uses Python / FastAPI, React, and Docker. See the development guide for local setup, project structure, and tests.

Bug reports and pull requests are welcome. Include reproduction steps for bugs and relevant validation for code changes. Report vulnerabilities privately as described in SECURITY.md.

License

Original source code is MIT licensed. Runtime images include separately licensed components, including Xpra (GPL v2 or later). See third-party notices and image distribution guidance.

—/ 5

No ratings yet

Manifest verification required

Commit 97706906f892

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout