OpenAdapt compiles a demonstrated GUI workflow into a deterministic, locally executable program with governance and verification, supporting browser, desktop, RDP, and Citrix surfaces. It emphasizes no model calls on healthy runs and provides a unified CLI via pip install openadapt.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (2 so far).
What it is
OpenAdapt is a system that compiles a demonstrated GUI workflow into an inspectable, locally executable workflow. It runs across browser, Windows, macOS, Linux, RDP, and Citrix/VDI, aiming to avoid model calls on healthy runs and to halt for review when necessary. The repository provides the unified openadapt CLI and packaging surface; the compiler and governed runtime live in openadapt-flow.
How it works
The project retains evidence from demonstrations (structural, accessibility, visual, OCR, etc.) to drive deterministic healthy runs. If a repair is needed, it can be governed and versioned. It separates action delivery from outcome verification, allowing qualified results to be reported only after verification. Remote execution operates via a customer-controlled runner without requiring OpenAdapt inside the remote session.
Getting started
Try locally with Python 3.10–3.12 and the browser capability for the bundled tutorial:
python -m pip install --upgrade 'openadapt[browser]'
Run the complete bundled tutorial with one command:
openadapt quickstart
Inspect the workflow bundle and visualize:
openadapt flow visualize openadapt-quickstart/bundle --out graph.html
openadapt flow lint openadapt-quickstart/bundle
Record a workflow, then compile and replay:
openadapt flow record --backend web --url https://your-app.example --out rec
openadapt flow compile rec --out bundle --name my-workflow
openadapt flow replay bundle --url https://your-app.example --run-dir run
Install only needed capabilities for native or remote work via:
python -m pip install "openadapt[capture]" # local human demonstration
python -m pip install "openadapt[capture,windows]" # Windows UI Automation
python -m pip install "openadapt[capture,macos]" # macOS Accessibility
python -m pip install "openadapt[capture,linux]" # Linux AT-SPI
python -m pip install "openadapt[capture,rdp]" # RDP transport
python -m pip install "openadapt[privacy]" # PII/PHI scrubbing
OpenAdapt Desktop is also available for the visual authoring and review experience.
Recent releases
Latest releases include:
- v1.10.2 (2026-07-28): Bug Fixes including Refuse launcher capture before readiness
- v1.10.1 (2026-07-28): Bug Fixes including Regenerate platform manifest for openadapt-flow 1.25.1
- v1.10.0 (2026-07-27): Bug Fixes including manifest: Correct published digests and drift detection
- v1.9.0 (2026-07-26): Chores including Refresh published platform manifest
- v1.8.0 (2026-07-26): Build System changes updating deps such as astral-sh/setup-uv
Traction
Stars: 1661; Forks: 259; Open issues: 1
Behind the repo
Launcher, packaging, and unified-CLI surface provided here; compiler and governed runtime implemented in openadapt-flow. Documentation and desktop integration are external surfaces referenced in the project map.
Caveats
License: MIT. Requires Python 3.10–3.12. The bundled tutorial is a tutorial, not production certification. The repository notes that the pre-1.0 monolith remains available under legacy with migration guidance.