# Run an Android emulator in the cloud. Free.

Run an Android emulator in the cloud, for free. Use the Codespaces hours included in your GitHub plan. Paste one prompt into your coding agent.

Emuly runs a real Android emulator in your own GitHub Codespace, with KVM hardware acceleration. It uses the hours your GitHub plan already includes, so there is nothing to pay. Use the phone in the browser, with adb and scrcpy, or let an AI coding agent drive it over the HTTP API.

## Get started

Paste the setup prompt into any coding agent: https://emuly.xyz/agent.md

Or install the agent skill: `npx skills add https://emuly.xyz`

Works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Cline, Roo Code, OpenCode, Devin, Zed, Kiro and other agents.

## The essentials

- **Free**: uses your Codespaces hours. No card.
- **Safe to stop**: only deleting it erases the phone.
- **Your way**: use it in the browser, or with adb and scrcpy.

## Questions

### How do I run an Android emulator in the cloud for free?

Copy the Emuly prompt and paste it into your coding agent, such as Claude Code, Codex or Cursor. The agent asks you to sign in to GitHub once. Then it starts an Android emulator in your own GitHub Codespace, on the free hours your GitHub plan includes.

### Is it really free?

Yes. You bring the compute through the Codespaces hours included in your GitHub plan. Emuly never bills you or resells GitHub. Stay within your included hours to avoid GitHub charges.

### Can AI agents control the phone?

Yes. Emuly has an HTTP API and an agent playbook. An agent can take screenshots, read the UI tree, tap, type, install APKs and record the screen. It also works with adb and scrcpy.

### What does it need from GitHub?

One permission: Codespaces. No repo access. Your agent asks you to sign in when it needs approval.

### What happens when I stop it?

Your codespace keeps the phone. Waking it boots Android fresh, which takes a few minutes. Only deleting the codespace erases it. GitHub deletes a stopped phone after its retention period. New phones get 30 days after the last stop. The console shows each phone's countdown.

### Is it fast?

Yes. Android runs with hardware acceleration (KVM) on the codespace machine. It is not slow software emulation, so apps open and respond quickly.

### Limits?

Running phones share your hours. GitHub decides how many codespaces you can have and run. GitHub stops an idle phone after 30 minutes or 4 hours, your choice. Cold boot takes about 2 minutes. Hours shown in the console are estimates.

### Can I host it myself?

Yes. One Docker container runs the whole app on your machine, with your own GitHub account. Your agent does the setup from one prompt. You only sign in to GitHub. [See how self-hosting works](https://emuly.xyz/self-host.md).

## Links

- Self-host: https://emuly.xyz/self-host.md
- Source code: https://github.com/codewarnab/emuly
