/* remove background color of images in code group */
[data-component-part="code-group-tab-bar"] img {
  background-color: transparent !important;
}


.mint-m-0 {
    margin: 0px
}
.mint-mr-2 {
    margin-right: 0.5rem
}
.mint-flex {
    display: flex
}
.mint-inline-flex {
    display: inline-flex
}
.mint-h-5 {
    height: 1.25rem
}
.mint-w-5 {
    width: 1.25rem
}
.mint-w-full {
    width: 100%
}
.mint-border-collapse {
    border-collapse: collapse
}
.mint-items-center {
    align-items: center
}
.mint-justify-center {
    justify-content: center
}
.mint-gap-1 {
    gap: 0.25rem
}
.mint-overflow-hidden {
    overflow: hidden
}
.mint-rounded-lg {
    border-radius: 0.5rem
}
.mint-border {
    border-width: 1px
}
.mint-border-gray-200 {
    --tw-border-opacity: 1;
    border-color: rgb(229 231 235 / var(--tw-border-opacity))
}
.mint-bg-gray-50 {
    --tw-bg-opacity: 1;
    background-color: rgb(249 250 251 / var(--tw-bg-opacity))
}
.mint-bg-white {
    --tw-bg-opacity: 1;
    background-color: rgb(255 255 255 / var(--tw-bg-opacity))
}
.mint-px-4 {
    padding-left: 1rem;
    padding-right: 1rem
}
.mint-py-3 {
    padding-top: 0.75rem;
    padding-bottom: 0.75rem
}
.mint-text-left {
    text-align: left
}
.mint-text-center {
    text-align: center
}
.mint-align-top {
    vertical-align: top
}
.mint-text-sm {
    font-size: 0.875rem;
    line-height: 1.25rem
}
.mint-text-xs {
    font-size: 0.75rem;
    line-height: 1rem
}
.mint-font-medium {
    font-weight: 500
}
.mint-uppercase {
    text-transform: uppercase
}
.mint-tracking-wider {
    letter-spacing: 0.05em
}
.mint-text-gray-500 {
    --tw-text-opacity: 1;
    color: rgb(107 114 128 / var(--tw-text-opacity))
}
.mint-text-gray-900 {
    --tw-text-opacity: 1;
    color: rgb(17 24 39 / var(--tw-text-opacity))
}
.mint-text-green-600 {
    --tw-text-opacity: 1;
    color: rgb(22 163 74 / var(--tw-text-opacity))
}
.mint-transition-colors {
    transition-property: color, background-color, border-color, text-decoration-color, fill, stroke;
    transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
    transition-duration: 150ms
}
.hover\:mint-bg-gray-100:hover {
    --tw-bg-opacity: 1;
    background-color: rgb(243 244 246 / var(--tw-bg-opacity))
}

Feature Categories

Support Status Legend

Usage Recommendations

Feature Support Comparison

Feature Map

Gbox docs

Welcome to gbox.ai, an android runtime for AI agents. When your agent needs to use an Android phone, Gbox can quickly help you set up this environment.

Introduction

This guide will show you how to create your first box

Quickstart

API Key

Basic

AI Action

Live View

Install app

Real Device

Playwright with Gbox

Execute code in multiple languages directly on Gbox

Explore how to connect Gbox with your favorite platforms and services.

Develop AI Agents that can browse the web autonomously using Gbox and AgentKit (by inngest).

AgentKit

Mastra

Create android box

Create linux box

List box

Terminate a running box. This action will stop the box and release its resources

Terminate box

Get box

Start box

Stop box

This endpoint allows you to generate a pre-signed URL for accessing the live view of a running box. The URL is valid for a limited time and can be used to view the box's live stream

Live view url

This endpoint allows you to generate a pre-signed URL for accessing the web terminal of a running box. The URL is valid for a limited time and can be used to access the box's terminal interface

Web terminal url

Retrieve the current display properties for a running box. This endpoint provides details about the box's screen resolution, orientation, and other visual properties

Get box display

Use natural language instructions to perform UI operations on the box. You can describe what you want to do in plain language (e.g., 'click the login button', 'scroll down to find settings', 'input my email address'), and the AI will automatically convert your instruction into the appropriate UI action and execute it on the box.

AI action

Click

Touch

Drag

Scroll

Performs a swipe in the specified direction

Swipe

Simulates pressing a specific key by triggering the complete keyboard key event chain (keydown, keypress, keyup). Use this to activate keyboard key event listeners such as shortcuts or form submissions.

Press key

Press button on the device. like power button, volume up button, volume down button, etc.

Press button

Directly inputs text content without triggering physical key events (keydown, etc.), ideal for quickly filling large amounts of text when intermediate input events aren't needed.

Type text

Move to position

Rotate screen

Take screenshot

Extract data from the UI interface using a JSON schema.

Extract data

Run code on the box

Execute a command on a running box. This endpoint allows you to send commands to the box and receive the output

Exec command

List box files

Get file/dir

Read box file

Creates or overwrites a file. Creates necessary directories in the path if they don't exist. If target path is already exists, the write will be failed.

Write box file

Delete a file or dir. If target path is not exists, the delete will be failed.

Delete box file/dir

Rename a file or dir. If target newPath is already exists, the rename will be failed.

Rename box/dir

Check if file/dir exists

This endpoint allows you to generate a pre-signed URL for accessing the Chrome DevTools Protocol (CDP) of a running box. The URL is valid for a limited time and can be used to interact with the box's browser environment

Generate CDP url

List apps

Get app

Get pkg

Uninstall app

Open app

Close app

Close all apps

Get pkg activities

Restart app

Retrieve detailed information for all installed pkg. This endpoint provides comprehensive pkg details

List pkg

A faster endpoint to quickly retrieve basic pkg information. This API provides better performance for scenarios where you need to get essential pkg details quickly

		Android	Linux
Basic	Create	✅supported	✅supported
	List	✅supported	✅supported
	Terminate	✅supported	✅supported
	Start	⏳Coming soon	⏳Coming soon
	Stop	⏳Coming soon	⏳Coming soon
	Live View	✅supported	✅supported
	Web Terminal	✅supported	✅supported
UI Action	Click	✅supported	⏳Coming soon
	Touch	✅supported	⏳Coming soon
	Drag	✅supported	⏳Coming soon
	Scroll	✅supported	⏳Coming soon
	Swipe	✅supported	⏳Coming soon
	Press Key	✅supported	⏳Coming soon
	Press Button	✅supported	⏳Coming soon
	Type Text	✅supported	⏳Coming soon
	Move to position	✅supported	⏳Coming soon
	Take Screenshot	✅supported	⏳Coming soon
	Screen Rotate	⏳Coming soon	⏳Coming soon
Run Code	Run Code	⏳Coming soon	✅supported
Command	Command	⏳Coming soon	✅supported
File System	List Box Files	⏳Coming soon	✅supported
	Get File/Dir	⏳Coming soon	✅supported
	Read File	⏳Coming soon	✅supported
	Write File	⏳Coming soon	✅supported
	Delete File/Dir	⏳Coming soon	✅supported
	Rename File/Dir	⏳Coming soon	✅supported
	Check if file/dir exists	⏳Coming soon	✅supported
Browser	Generate CDP url	⏳Coming soon	✅supported
Android	List apps	✅supported	➖
	Install app	✅supported	➖
	Uninstall app	✅supported	➖
	List app simple	✅supported	➖
	Get App	✅supported	➖
	Get connect address	✅supported	➖
	Get app activities	✅supported	➖
	Open App	✅supported	➖
	Close App	✅supported	➖
	Close all apps	✅supported	➖
	Restart app	✅supported	➖
	Backup all apps	⏳Coming soon	➖
	Backup app	⏳Coming soon	➖
	Restore app	⏳Coming soon	➖

​Feature Support Comparison

​Feature Categories

​Support Status Legend

​Usage Recommendations

Feature Support Comparison

Feature Categories

Support Status Legend

Usage Recommendations