High-Performance, Persistent Virtual Machines on GitHub Actions
Antigravity VM Suite transforms GitHub Actions into a powerful workspace provider. Get a temporary, remote desktop environment for Windows, macOS, or Ubuntu in just 2 minutes—perfect for heavy development, testing, or bypass tasks.
| 💻 OS Support | 🔒 Connectivity | 💾 Persistence |
|---|---|---|
| Windows (Latest/11-ARM) | RDP (Remote Desktop) | R2 Storage (Browser Profiles) |
| macOS (Latest) | VNC (Screen Sharing) | GitHub Artifacts (Env State) |
| Ubuntu (Latest) | SSH (Secure Shell) | Session Restore (Auto-pick up) |
- Dual Tunneling: Support for both
ngrokandcloudflaredfor rock-solid stability. - Audio Support: Virtual sound card integration for Windows RDP.
- One-Click Setup: Pre-install VS Code, Android Studio, GitHub Desktop, and more.
- Multi-Profile Sync: Persistent Chrome profiles including accounts and extensions.
- Fork this Repository: Create your private environment instance.
- Configure Secrets: Go to
Settings > Secrets > Actionsand add:USER_PASSWORD: Your VM login password.NGROK_AUTH_TOKEN: (Optional) For ngrok tunnels.R2_ACCESS_KEY_ID,R2_SECRET_ACCESS_KEY, etc. (Optional, for Browser Persistence).
- Trigger Workflow:
- Go to the Actions tab.
- Select Remote Desktop Access.
- Click Run workflow & choose your OS.
- Connect: Find the connection address in the Display Connection Details step of the runner logs.
We provide two distinct ways to keep your work safe:
New! Specifically designed for high-performance syncing of Google Chrome profiles.
- Syncs bookmarks, passwords, and all logged-in Google accounts.
- Excludes bulky cache to keep startup/shutdown fast.
- Read the Browser Persistence Guide →
Classic persistence for environment variables, chat history, and local coding configurations.
- Saves to GitHub Artifacts (90-day retention).
- Restores automatically on every run.
- Read the Persistence Technical Guide →
Explore our detailed guides to master your environment:
- Installation Guide: Recommended clients for RDP and VNC.
- Configuration Matrix: Every toggle, input, and secret explained.
- VM Specifications: CPU, RAM, and Storage breakdown for each runner.
- Software Catalog: List of all optional software you can auto-install.
- SSH & Termius: Setting up secure terminal-only access.
- Technical Breakdown: How we use Rclone, Ngrok, and PowerShell to automate the cloud.
This project is for educational and development purposes. Please adhere to the GitHub Actions Terms of Service. The macOS and Ubuntu workflows are community-maintained.