overlord logo

overlord

by hanzoai

AI Overlord manages disparate agents through local computer use, allowing AI to control macOS natively. It provides direct system control through native macOS commands and utilities.

View on GitHub

Last updated: N/A

What is overlord?

Overlord is a project that enables AI to control macOS natively, providing direct system control through native macOS commands and utilities. It allows AI agents to interact with the macOS GUI, capture the screen, control keyboard and mouse, and interact with the file system.

How to use overlord?

To use Overlord, clone the repository, create a virtual environment, run the setup script, install Python requirements, configure your API key in a .env file, and start the Streamlit app. The interface will then be available at http://localhost:8501.

Key features of overlord

  • Native macOS GUI interaction

  • Screen capture using native macOS commands

  • Keyboard and mouse control through cliclick

  • Multiple LLM provider support

  • Streamlit-based interface

  • Automatic screen resolution scaling

  • File system interaction and editing capabilities

Use cases of overlord

  • Automated testing

  • Robotic Process Automation (RPA) on macOS

  • AI-driven task automation

  • Remote system administration

  • AI-assisted software development

FAQ from overlord

What macOS version is required?

macOS Sonoma 15.7 or later.

What Python version is required?

Python 3.12+

What is cliclick and why is it needed?

cliclick is a command-line tool used for mouse and keyboard control on macOS. It is required for Overlord to interact with the GUI.

Which LLM providers are supported?

Anthropic, Bedrock, and Vertex are supported.

What screen resolutions are recommended?

XGA (1024x768), WXGA (1280x800), and FWXGA (1366x768) are recommended for optimal performance.