FlowDesk is a visual desktop automation tool that allows you to build and run workflows by connecting nodes on a canvas.
It combines a React-based UI with a FastAPI backend and executes automation directly on your local machine using PyAutoGUI.
- 🧩 Visual Workflow Builder Create automation flows by dragging and connecting nodes
- 🖱 Desktop Automation
Automate mouse actions:
- Image-based clicking
- Coordinate clicking
- Waiting / conditional waiting
- Loop execution
- 📡 Real-time Execution Feedback See which node is running and track loop progress live
- ⚡ Single EXE Runtime
- No need to install Python or Node.js
- Automatically opens in your browser
- Frontend and backend bundled together
- React
- React Flow
- Vite
- FastAPI
- Uvicorn
- Pydantic
- PyAutoGUI
FlowDesk/
├── backend/
│ └── backend.py
├── frontend/
│ ├── src/
│ └── dist/
git clone https://github.com/NevinRock/FlowDesk.git
cd FlowDesk
cd backend
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
Run backend:
python backend.py
cd frontend
npm install
npm run dev
cd frontend
npm run build
backend\venv\Scripts\python -m PyInstaller ^
--clean --noconfirm --onefile ^
--name FlowDesk ^
backend\backend.py ^
--add-data "frontend\dist;frontend_dist"
dist\FlowDesk.exe
- Launch FlowDesk
- Create a workflow using nodes
- Click Run
- Watch the automation execute on your desktop
- Works only on local machines with a GUI
- May require system permissions (especially on macOS)
- Antivirus software may block automation behavior
Check the terminal output and open the displayed URL manually.
- Make sure you're not using the Vite dev URL (
localhost:5173) - Open the app from the backend address instead
- Ensure you're running locally (not on a server)
- Check system permissions
The following are ignored:
venv/dist/build/*.exe*.spec
You need to build the EXE locally.
MIT