Design & media

android-lab

Try it

Install Android Lab's local Docker images, then build an Android app, boot a private emulator, install APKs and inspect the UI from the app's own directory. Use when an Android build or emulator is needed without a host SDK or ADB.

What it does

Android Lab is a set of locally built Docker images: a tool image with the Android SDK, Gradle runner and device scripts, and an emulator image. Everything runs from the Android project's own directory. No lab checkout, host SDK or host ADB is needed.

The skill document

Android Lab

Android Lab is a set of locally built Docker images: a tool image with the Android SDK, Gradle runner and device scripts, and an emulator image. Everything runs from the Android project's own directory. No lab checkout, host SDK or host ADB is needed.

Run every command from the Android project root. Never use host adb, a host Android SDK, USB devices or physical phones. All device commands reach only the lab's private emulator.

1. Check the host

  • Linux on x86_64 with Docker and Docker Compose v2, plus git and curl.
  • The emulator needs /dev/kvm on the Docker host. Builds do not.
  • docker info must succeed as the current user.

2. Pick a version

Use the version the project already pins: look for android-lab: or ANDROID_LAB_VERSION in its Makefile, Dockerfiles, CI workflows and docs. If it pins none, list the releases and take the highest:

git ls-remote --tags --refs https://github.com/psyb0t/android-lab.git 'v*' | sed 's|.*refs/tags/v||' | sort -V | tail -1

Tell the user which version you chose and why. Use that exact version for every command below, written here as ``.

The image build downloads the Android SDK. Show the user https://developer.android.com/studio/terms and ask whether they accept it. Only after an explicit yes, set ANDROID_LAB_ACCEPT_ANDROID_LICENSES=yes. Never accept it on their behalf.

4. Install the images

Download the installer from the release tag, read it, then run it as a file:

curl -fsSLo /tmp/android-lab-install.sh https://raw.githubusercontent.com/psyb0t/android-lab/v/install.sh
ANDROID_LAB_ACCEPT_ANDROID_LICENSES=yes bash /tmp/android-lab-install.sh  --emulator

It builds android-lab: and android-lab:-emulator-api36, keeps images that already exist, and prints their names. Drop --emulator when only builds are needed. A first build takes several minutes. When the installer runs inside a container that uses the host Docker socket, add --work-dir with a directory that exists at the same path on the host.

5. Build, run and inspect

Read commands before running anything here. It has the exact docker run commands for:

  • a Gradle task such as :app:assembleDebug;
  • starting the emulator and opening its viewer;
  • installing an APK, starting an app, UI layout, screenshots, shell and file transfer;
  • forwarding a device port to the host and stopping the lab.

Prefer the project's own Makefile targets when it already integrates Android Lab. Inspect UI with the compact layout JSON first, then screenshots.

Boundaries

  • Keep .android-lab/ in the project's .gitignore. It holds caches, the signing identity and the saved phone. Do not delete it.
  • Stop the lab when the user is done, unless they asked to keep it running. Stopping keeps the phone disk.
  • Do not substitute a different image version, pull SDK images from a registry, or publish the built images.

Done when

The requested build, install or inspection command exited 0, and its output exists: the APK under the project's build directory, or layout.json and screenshot.png under .android-lab/shared/artifacts/. Report the version used and whether the emulator is still running.

Related skills

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván857 installs69 stars

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván561 installs18 stars

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

More from psyb0t

Browse all skills

Drive a user-deployed mt5-httpapi MetaTrader 5 bridge over HTTP, with per-action confirmation on every real-money call.

by psyb0t108 installs4 stars

Docker-packaged browser automation for QA against anti-bot stacks and authorized detection testing.

by psyb0t138 installs2 stars

Self-hosted OpenAI-compatible speech service — transcription, translation, and synthesis from one container.

by psyb0t13 installs

Run ffmpeg, sox, and ImageMagick jobs against your files in a fixed-allowlist SSH sandbox.

by psyb0t71 installs

Generate speech audio via Qwen3-TTS over SSH with preset voices, voice cloning, and voice design.

by psyb0t55 installs

Drive one or more IMAP/SMTP mailboxes through a single REST + MCP endpoint — read, search, send, mark-seen, and delete across accounts in parallel.

by psyb0t15 installs