paint051225.mp4
Terminator is the fastest, AI-first, computer use SDK. It's designed to interact with native GUI applications on Windows using a Playwright-like API, like parsing a website. By leveraging OS-level accessibility APIs, Terminator is significantly faster and more reliable for AI agents than vision-based approaches, and can interact with background applications.
โ ๏ธ Experimentalโ ๏ธ : Terminator is under active development. Expect bugs and breaking changes. Please report issues โ we aim to fix them quickly!
Operating System | Support Status | Key Characteristics |
---|---|---|
Windows | โ Active Focus | Full features, best performance, actively developed & documented. |
macOS | ๐ก Partial | Core functionality available; community-driven, less documented. |
Linux | โ No Support | Not currently supported. |
- AI-First & Agentic: Built from the ground up for modern AI agents and workflows.
- Blazing Fast & Reliable: Uses OS-level accessibility APIs, making it much faster and more robust than vision-based tools.
- Playwright-Style API: Offers a familiar, powerful, and developer-friendly interface.
- Cross-Platform (Windows Focus): Automate native GUI applications on Windows (primary) and macOS.
- Deep UI Introspection: Enables detailed understanding and control of complex UI elements.
- Background App Interaction: Capable of interacting with applications even if they are not in focus.
Check out Terminator in action:
- ๐น Desktop Copilot that autocompletes your work in real time
- ๐น AI Agent that process 100 insurance claims in 5 minutes
- ๐น Technical Overview Video
- ๐น Technical Overview: PDF to Windows Legacy App Form
For detailed information on features, installation, usage, and the API, please visit the Official Documentation.
Get up and running with Terminator:
- Clone the repo:
git clone https://github.com/mediar-ai/terminator cd terminator
- Set up the server:
- Windows: Download & unzip the pre-built server using PowerShell:
powershell -ExecutionPolicy Bypass -File .\setup_windows.ps1
- macOS: Compile the server using Rust/Cargo (ensure Rust and Xcode Command Line Tools are installed):
cargo build --release --package server
- Windows: Download & unzip the pre-built server using PowerShell:
- Run the server:
- Windows:
./server_release/server.exe --debug
- macOS:
./target/release/examples/server --debug
- Windows:
- Run an example client (in a separate terminal):
Navigate to the example directory, install dependencies, and run:
cd examples/hello-world npm i npm run dev # Then, open http://localhost:3000 in your browser
For more details, see the Getting Started Guide in the docs.
- Vercel AI SDK Example: Learn how to use Terminator with AI in the PDF-to-Form example.
- MCP: Discover how to Vibe Work using MCP.
- Windows: uiautomation-rs
- macOS: Native macOS Accessibility API (exploring cidre as an alternative)
- Windows:
- Accessibility Insights for Windows
- FlaUInspect: A recommended alternative for inspecting UI Automation properties on Windows.
- Install:
choco install flauinspect
or download from FlaUI/FlaUInspect releases. - Usage: Launch
FlaUInspect.exe
, hover or click on elements to see properties likeAutomationId
,Name
, andControlType
. This is great for debugging selectors.
- Install:
contributions are welcome! please feel free to submit issues and pull requests. many parts are experimental, and help is appreciated. join our discord to discuss.
if you want desktop automation at scale for your business, let's talk