AI can dispatch tasks across multiple cloud phones, monitor progress in one place, and collect results centrally

AI Workflow: AI turns the task into scripted steps first, then executes them automatically for fixed and repeatable jobs

AI Agent: AI makes decisions in real time, watching the interface and acting during execution for dynamic tasks

VMOS Edge Desktop is the desktop control client for the VMOS Edge locally deployed Android cloud phone platform. Powered by a self-developed Android virtualization engine and local edge hardware, it delivers low-latency, stable cloud-phone management and automation for developers and power users.

From the desktop app, you can centrally manage multiple boxes and cloud phones, control screens, manage images and hosts, and connect AI Workflow, AI Agent, and API integrations. This repository provides the open-source implementation of that client for learning, customization, and integration around VMOS Edge capabilities.

• Windows: Windows 10 (64-bit) or later
• macOS: macOS 10.15 Catalina or later
• Linux: Ubuntu 18.04 or equivalent Linux distribution
• Memory: 4GB RAM (8GB recommended)
• Storage: 2GB available disk space

• Node.js: >= 18.0.0
• pnpm: >= 9.7.1 (recommended package manager)
• Python: >= 3.8 (for building native dependencies)

1. Clone the repository

git clone https://github.com/vmos-dev/vmos-edge-desktop.git
cd vmos-edge-desktop

2. Install dependencies

pnpm install

3. Start the development server

pnpm dev

The app starts in development mode with hot reload and debugging tools enabled.

# Format code
pnpm format

# ESLint checks
pnpm lint

# TypeScript type checks
pnpm typecheck

# Build without packaging (for testing)
pnpm build

# Build and generate the unpacked app
pnpm build:unpack

# Build Windows installer (.exe)
pnpm build:win

# Build macOS Intel version (.dmg)
pnpm build:mac:intel

# Build macOS Apple Silicon version (.dmg)
pnpm build:mac:arm

# Build Linux packages (.AppImage, .deb)
pnpm build:linux

After the build completes, the installers will be generated in the dist/ directory:

• Windows: VMOS Edge Setup 2.1.5.exe
• macOS: VMOS Edge-2.1.5.dmg
• Linux: VMOS Edge-2.1.5.AppImage / vmos-edge-desktop_2.1.5_amd64.deb

1. Dependency installation failed

# Clear cache and reinstall
pnpm store prune
rm -rf node_modules
pnpm install

2. Build failed (native dependencies)

• Make sure Python 3.8+ is installed
• Windows: install Visual Studio Build Tools
• macOS: install Xcode Command Line Tools
• Linux: install build-essential

3. App failed to start

• Check whether another instance is already running
• Clear the app data directory: ~/.vmos-edge-desktop

• Press F12 in development mode to open DevTools
• Main process logs: logs/main.log
• Renderer process logs: logs/renderer.log

This project is released under GPL-3.0. You may use, modify, and distribute it under the terms of GPL-3.0.

If you need closed-source commercial use, distribution rights, OEM integration, or another arrangement that does not fit GPL-3.0, contact vmosedge@vmos.cn for a separate commercial license.