Install OpenAdapt

Start with the OpenAdapt CLI

The flagship OpenAdapt project installs the compiler and governed runtime under the unified openadapt flow command. Native installers are generated separately from the latest complete Experimental desktop prerelease.

pip install openadapt

Read docs View desktop builds

Desktop packaging

Native installer preview

Experimental prerelease desktop-v0.6.2

Choose the build that matches your operating system and processor below.

All downloads

Every installer for the latest Experimental prerelease (desktop-v0.6.2). Choose the one that matches your machine.

Windows (x64)

.msi installer (or .exe) · 70.0 MB

Download →

macOS (Apple Silicon)

.dmg for M1 and later · 51.2 MB

Download →

macOS (Intel)

.dmg for Intel Macs · 59.9 MB

Download →

Linux (x64)

.AppImage (or .deb) · 176.4 MB

Download →

Looking for a different build or an older version? Browse all releases on GitHub.

What you're installing

Real screenshots, honest state

These are unretouched captures of the actual Experimental surfaces — shown in the state a first launch honestly renders, not a mockup of a finished product. The desktop app now launches: v0.6.2 fixes the earlier startup panic (issue #26), and the window below is the real app running.

OpenAdapt Desktop connect screen from the real launched app: a Sign in card with a host field, a browser sign-in button, and an ingest-token paste option. — **The desktop app's connect screen** — the real window from the launched Experimental app (the published v0.6.2 DMG, which fixes the earlier startup panic, issue #26) with no engine attached. First launch asks you to sign in or paste an ingest token; workflow authoring surfaces open after the engine connects. Experimental prerelease, unsigned or ad-hoc-signed builds — see the release notes before installing.

The openadapt-tray menu open in the macOS menu bar with items for Start Recording, Recent Captures, Open Desktop App, Open Cloud Dashboard, Sync (offline), Login, Settings, and Quit. — **The experimental tray companion** — `openadapt-tray` 0.1.1, a separate `pip install openadapt-tray` package, captured live on macOS in its real standalone state. It mirrors status and launches surfaces; it is not included in the installers on this page, and no released desktop build provides the companion service it connects to yet.

Windows install flow

The real NSIS installer, start to finish

Captured from the actual windows-x86_64-unsigned-nsis-setup.exe (v0.6.1) running on a real Windows 11 machine. Experimental prerelease, unsigned — Windows shows an Unknown Publisher warning (expected); see First launch below for how to proceed safely.

NSIS setup wizard welcome page reading "Welcome to OpenAdapt Desktop Setup" with a Next button. — Step 1. Welcome — the NSIS setup wizard opens.

Choose Install Location page defaulting to a per-user path under AppData\Local\OpenAdapt Desktop; the footer reads Nullsoft Install System v3.11. — Step 2. Choose location — a per-user install to %LOCALAPPDATA%\OpenAdapt Desktop, no admin rights needed.

Completing page reading "Completing OpenAdapt Desktop Setup" with "Run OpenAdapt Desktop" and "Create desktop shortcut" checked. — Step 3. Finish — files are placed and the app launches. Earlier prereleases panicked on startup (issue #26); v0.6.2 fixes it — the running connect screen above is that first launch.

Capture provenance for every screenshot is recorded in the media manifest.

First launch

Current Experimental builds may trigger an operating-system publisher warning. Verify the release checksum before overriding it.

macOS

The DMGs are ad-hoc signed, not yet Developer ID notarized. In Finder, Control-click OpenAdapt Desktop, choose Open, then confirm Open. Only override Gatekeeper after verifying the release checksum.

Windows

The Windows installers are not yet Authenticode signed, so Windows warns that the publisher is unknown — this is expected. On the "Open File - Security Warning" dialog shown below (or a SmartScreen "Windows protected your PC" prompt, where you choose More info), verify the release checksum first, then choose Run.

Download SHA256SUMS and verify GitHub build provenance from the release before installing.

Need the working workflow engine?

Start with pip install openadapt, or bring the workflow you most want to automate to a 30-minute call.

Try locally Read docs