AkaPhone documentation
Cloud Android phones for AI agents and people. Create a device, tell it what to do in plain English, and watch it work.
AkaPhone runs real Android 14 systems in the cloud and hands them to you, or to your coding agent, as a tool. Each device is a full Android phone in its own container. You can watch its screen live in the browser, tap and type on it, install your own APKs, save its state as a snapshot, and give it plain-English tasks such as “Open Settings and turn on dark mode”.
Tasks are carried out by ARTEMIS, Google's open-source Android agent, running unmodified on the device host. It uses your own Gemini, Claude or OpenAI key. AkaPhone bills device time, not tokens.
Three ways to use it#
Five-minute tour#
-
Sign in at https://akaphone.abhgnx-417.workers.dev with Google. New accounts get 60 free credit minutes, which is 60 minutes of one running device. No card needed.
-
Create an API key on the API keys page. It starts with
ak_live_and is shown once. -
Connect your agent. For Claude Code that is one command:
Shellclaude mcp add akaphone \ -e AKAPHONE_API_KEY=ak_live_... \ -e MODEL_API_KEY=AIza... \ -- npx -y akaphone-mcp -
Ask for something. “Create a phone, open Settings > About phone and tell me the Android version. Then terminate it.”
-
Watch it in the dashboard while it runs, and check Usage afterwards to see the minutes it used.
Or skip the agent and do the same thing over HTTP:
curl -X POST https://akaphone.abhgnx-417.workers.dev/v1/devices \
-H "Authorization: Bearer $AKAPHONE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "first-phone", "wait": true}'const res = await fetch("https://akaphone.abhgnx-417.workers.dev/v1/devices", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.AKAPHONE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ name: "first-phone", wait: true }),
});
const device = await res.json();
console.log(device.id, device.status); // dev_s6zr7mr4f2f1 runningimport os, requests
r = requests.post(
"https://akaphone.abhgnx-417.workers.dev/v1/devices",
headers={"Authorization": f"Bearer {os.environ['AKAPHONE_API_KEY']}"},
json={"name": "first-phone", "wait": True},
)
device = r.json()
print(device["id"], device["status"]) # dev_s6zr7mr4f2f1 runningWhat you get#
| Devices | Android 14 (pixel_8 profile, 720×1560) in an isolated container. Up to 1, 3 or 5 at once depending on your plan. Devices → |
| Tasks | Plain-English instructions carried out by ARTEMIS with your model key, with step-by-step progress, a screen recording, before/after screenshots, a trace and a log. Tasks → |
| Live view | The screen streamed to your browser at 2–5 fps, with tap, swipe, type and hardware keys. Streaming → |
| APKs | Drag an APK onto the device in the dashboard, or upload it over the API. Up to 300 MB. Install an APK → |
| Snapshots | Save a configured device (apps, logins, settings) and boot new devices from it. Snapshots → |
| Credits | Prepaid packs from $10. One credit is one device-minute. No subscription. Credits and plans → |
For agents#
This site is also published as plain text for language models: /llms.txt is an index of every page with a one-line summary, and /llms-full.txt is the whole site in one file. Every page is available as Markdown by adding .md to its path, for example /api/devices.md.