terminator 🤖

paint051225.mp4

Automate desktop apps like a browser. AI-native GUI automation for Windows, MacOS, Linux. Fast, reliable, agent-ready.

⚡ TL;DR — Hello World Example

Skip the boilerplate. This is the fastest way to feel the magic.

🐍 Python

pip install terminator-py

import terminator
desktop = terminator.Desktop()
desktop.open_application('calc')
seven = desktop.locator('name:Seven')
seven.click()

🟦 TypeScript / Node.js

bun i terminator.js # or npm, pnpm, yarn

const { Desktop } = require('terminator.js');
const desktop = new Desktop();
await desktop.openApplication('notepad')
await desktop.locator('name:Edit').typeText('hello world')

🧠 What is Terminator?

Terminator is the Playwright-style SDK for automating Windows GUI apps.

• 🪟 Built for Windows, works on Linux & macOS (partial)
• 🧠 Designed for AI agents, not humans
• ⚡ Uses OS-level accessibility (not vision)
• 🧩 TS, Python, and Rust support
• 📈 80ms UI scans, 10000x speedup via compiled workflows

Documentation

For detailed information on features, installation, usage, and the API, please visit the Official Documentation.

Explore Further

• https://github.com/mediar-ai/terminator-typescript-examples
• https://github.com/mediar-ai/terminator-python-examples
• https://github.com/mediar-ai/terminator/examples

contributing

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.

businesses

if you want desktop automation at scale for your business, let's talk