---
id: e2b-desktop
version: "2.4.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# e2b-desktop — E2B Desktop Sandbox - Deskstop sandbox in cloud powered by E2B

License: permissive · Maintenance: active · Downloads: 197.5K/mo

## What it is and what it does

E2B Desktop Sandbox is a Python SDK that provisions isolated virtual desktop environments running on E2B's cloud infrastructure. Each sandbox is a Linux-based Xfce desktop where you can launch applications, capture screenshots, stream the display, and control mouse and keyboard input programmatically. The package wraps the E2B Sandbox platform with desktop-specific APIs for computer use automation tasks.

You interact with sandboxes through a simple Python object model: create a sandbox, launch applications, take screenshots, send input events, and stream the desktop to a browser or client. The package handles the underlying infrastructure provisioning and network communication. It depends on the base e2b SDK, pillow for image handling, and requests for HTTP operations.

Use it for:

- Automate GUI-based workflows in cloud-isolated environments without local desktop dependencies.
- Build AI agents that need to interact with graphical applications and capture visual feedback.
- Test desktop applications in a sandboxed, reproducible environment without affecting your local system.
- Stream a remote desktop to end users or monitoring systems for real-time interaction or observation.
- Run browser automation tasks that require a full graphical desktop rather than headless mode.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a Python SDK to create and control isolated virtual desktop environments in the cloud, with support for application launching, screen streaming, mouse/keyboard control, and screenshot capture.

Yes, if you need to automate or control graphical desktop applications in an isolated cloud environment and have an E2B API key. The package is actively maintained, has low install friction, carries no known vulnerabilities, and offers a clean Python API. The main decision point is whether the E2B service cost and API key requirement fit your use case.

## Install

pip install e2b-desktop
uv add e2b-desktop
poetry add e2b-desktop

## Installing e2b-desktop

Before you install: Low friction installation with a pure Python wheel. The package is actively maintained (last commit 2026-08-14) and has been in development since 2024-10-24. Supports current Python versions (3.10–3.14).

License in practice: MIT license permits commercial and private use with minimal restrictions; you must include a copy of the license and copyright notice in distributions.

Quickstart:

pip install e2b-desktop

from e2b_desktop import Sandbox

desktop = Sandbox.create()
desktop.launch('google-chrome')
image = desktop.screenshot()
desktop.kill()

Requires E2B_API_KEY environment variable set with a valid E2B API key (obtain by signing up at e2b.dev).

Verify before relying:

- Pricing model and cost per sandbox instance or usage tier
- Geographic availability and latency characteristics of sandbox infrastructure
- Maximum concurrent sandboxes per API key or account
- Persistence and data retention policies for sandbox files and state

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 197.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

virtual desktop sandbox cloud, remote desktop automation SDK, computer use environment, headless desktop control, cloud-based GUI automation, isolated sandbox desktop, screen streaming API, cloud-automation, desktop-control, computer-use

[View on SkillFed](https://skillfed.io/packages/e2b-desktop) · [View on PyPI](https://pypi.org/project/e2b-desktop/)