LibreAI / AI Agents / macos-harness
// agents · browser-use/macos-harness

macos-harness

A minimal harness that lets an LLM fully control a Mac.

★ 902 stars⑂ 61 forksMITupdated 2026-08
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

macos-harness is an open-source ai agents project by browser-use (browser-use/macos-harness on GitHub). It has 902 GitHub stars and 61 forks, is released under the MIT license, and was last updated on GitHub on 17 August 2026.

GitHub stars
902
Forks
61
License
MIT
Last updated on GitHub
17 August 2026
Category
AI Agents
Listing
Full install guide
// how it works

How it works

  1. Clarify your goal

    Decide what you want the project to do before installing anything.

  2. Clone the repo

    Grab the source and skim the README for setup requirements.

  3. Install and configure

    Install dependencies and add any API keys or settings it needs.

  4. Run your first task

    Launch it and follow the example workflow from the docs.

// features

Why people love it

Full Mac control

Accessibility APIs drive real apps.

Minimal design

Thin on purpose - easy to understand.

LLM-agnostic

Bring your own model.

Computer-use

OS-level, not just browser-level.

MIT licensed

Free to hack on.

From browser-use team

Built by agent-infra veterans.

Advertisement
// run it

Run it yourself

  1. Step 1 - Clone the repo

    Download the source and move into the project folder.

    git clone https://github.com/browser-use/macos-harness.git
    cd macos-harness
  2. Step 2 - Install dependencies

    Create a virtual environment and install the requirements.

    python -m venv .venv && source .venv/bin/activate
    pip install -r requirements.txt
  3. Step 3 - Run an example

    Treat these as starting points - the README documents the exact commands.

    python examples/quickstart.py
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains macos-harness?

It is an open-source project at browser-use/macos-harness with 61 forks. Check the repo's contributors and recent commits to judge how active maintenance is.

Is macos-harness free to use?

Yes - it is MIT licensed, so you can use, modify, and distribute it freely, including in commercial projects.

Do I need a paid API to use it?

The harness is free; the model driving it is usually a paid API or a local model.

Is this safe to run?

It gives an LLM full control of your Mac - run it in a VM or a spare machine, never on your daily driver with sensitive data. Treat it as research tooling.

How do I get started?

Clone the repo, read the README's quickstart, and run the provided example - most projects get you to a first result in minutes.

// keep exploring

Similar tools

AI Agents

osaurus

Osaurus — own your AI: a native macOS agent harness with any model, memory and fully offline execution.

★ 8.0k starsMIT
View guide →
AI Agents

browser-harness

A self-healing harness that connects an LLM directly to your real browser

★ 18.4k starsMIT
View guide →
AI Agents

mobilerun

Control Android and iOS devices with natural language — an LLM-agnostic mobile agent framework and CLI.

★ 9.6k starsMIT
View guide →
AI Agents

browser-use

The open-source library that lets AI agents control a real browser.

★ 117.4k starsMIT
View guide →
AI Agents

MobileBuildMCP

An MCP server and CLI that lets AI agents build, test and run iOS and macOS projects.

★ 6.5k starsMIT
View guide →
AI Agents

lamda

FIRERPA / LAMDA — full-stack Android device control: remote desktop, automation, MITM, Frida and MCP.

★ 8.6k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if macos-harness is not the right fit.

Get macos-harness

Free and open — grab the source, star the repo, and start creating.