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 |
Quick links
- Repository — source, issues, discussions
- Releases — signed installer
(
VxDeskSetup-x.y.z.exe) and source archives - Contributing
- Security policy
- Changelog
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.