Skip to the content.

VxDesk Documentation

Fully-local desktop automation with an n8n-style visual workflow editor — "Playwright MCP, but for the desktop."

New here? Start with the interactive getting-started guide — it walks you from install to your first workflow in about five minutes.

Guides

Document What it covers
Architecture Components, capture/vision/input backends, workflow engine, data flow
API contract REST + WebSocket surface between the editor and the backend
Recorder Recording desktop interactions and converting them to workflows
AI Assistant Chat-driven workflow building; OpenAI-compatible providers
Remote services Hub ↔ agents over WebSocket / TCP / edge polling, tokens, TLS

The 30-second tour

git clone https://github.com/Huntz-Group/VxDesk.git
cd VxDesk
npm run setup   # one-time: backend venv + Python/npm deps
npm run dev     # backend on 127.0.0.1:8765, editor on localhost:7100

Then open the UI, run the pre-loaded Welcome · VxDesk tour (safe) workflow, and check runs/ for the screenshot it saves. Everything runs on your machine — no cloud, no telemetry.