// agents · microsoft/UFO

UFO

Microsoft's GUI agent that grew into UFO³ — orchestrating agents across Windows, Linux and mobile devices.

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

Project facts

UFO is an open-source ai agents project by microsoft (microsoft/UFO on GitHub). It has 9,961 GitHub stars and 1,068 forks, is released under the MIT license, and was last updated on GitHub on 7 October 2026.

Repository
microsoft/UFO
GitHub stars
9,961
Forks
1,068
License
MIT
Last updated on GitHub
7 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide whether you need single-device Windows automation (UFO²) or cross-device orchestration (UFO³ Galaxy), and which devices and LLM you will connect.

  2. Get the project

    Clone microsoft/UFO from GitHub (or use the install path in the run steps below) and skim its README for the parts relevant to your goal.

  3. Install and configure

    Clone the repo, install the Python requirements, then copy the Galaxy agent template and add your API keys, and register devices in the devices config.

  4. Run your first task

    Start the device agent server and client on each device (with the platform flags for Windows, Linux or Android), then give the ConstellationAgent a task and watch it split into a DAG.

// features

Why people love it

Galaxy multi-device orchestration

The Galaxy framework coordinates agents across multiple devices as one system, rather than automating a single desktop in isolation.

Constellation task DAGs

Tasks are decomposed into executable DAGs, with dynamic DAG editing so the workflow can adapt as execution evolves.

Asynchronous parallel execution

Constellation runs tasks asynchronously with parallel coordination across device agents.

Unified AIP protocol

Agents communicate over a unified AIP protocol designed for secure agent-to-agent communication.

UFO² Desktop AgentOS

The stable single-device path offers deep Windows OS integration and hybrid GUI plus API actions for reliable desktop automation.

Cross-platform device agents

Device agents run on Windows, Linux and mobile (Android), each starting a server, MCP servers where applicable, and a client.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source from the official GitHub repository for UFO.

    git clone https://github.com/microsoft/UFO.git
    cd UFO
  2. Install and configure

    Install dependencies, copy the Galaxy agent config template and add your API keys, as the README's quick start shows.

    pip install -r requirements.txt
    copy config\galaxy\agent.yaml.template config\galaxy\agent.yaml  # then edit in your API keys
  3. Register devices and start agents

    Edit the Galaxy devices file to register your devices, then start each device agent with its platform flags per the platform guides in the docs.

    # Edit config\galaxy\devices.yaml to register your devices
    # Then start server + client on each device — see README platform guides
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains UFO?

Microsoft, through the microsoft/UFO repository, with full documentation at microsoft.github.io/UFO.

Is UFO free to use?

Yes — the project is open source under the MIT license as recorded for this listing. You can use, modify and distribute it under the MIT terms.

Does UFO need a paid API key?

You need your own LLM API keys, added to the Galaxy agent configuration — UFO itself is free, but model usage is billed by your provider.

How does UFO compare to a single-device computer-use agent?

Single-device agents automate one desktop; UFO³ adds the Galaxy layer — task DAGs, parallel coordination and device agents across Windows, Linux and Android — while UFO² remains its proven single-Windows-device mode.

How do I get started with UFO?

Clone the repository (or use the documented installer), follow the install and configure steps on this page, and run the smallest real task first — start the device agent server and client on each device (with the platform flags for Windows, Linux or Android), then give the ConstellationAgent a task and watch it split into a DAG.

// keep exploring

Similar tools

AI Agents

MobileAgent

Mobile-Agent — multimodal GUI agents that operate phones and PCs from screenshots and instructions.

★ 9.3k starsMIT
View guide →
AI Agents

open-codex-computer-use

Open-source Computer Use as an MCP service: let any agent drive macOS, Linux, and Windows desktops.

★ 2.4k starsMIT
View guide →
Agents

OpenGUI

Android GUI agent framework: AI that sees, plans, and taps real mobile apps.

★ 1.8k starsCustom
View guide →
AI Agents

UI-TARS-desktop

ByteDance's open-source multimodal AI agent stack: GUI agents that see and operate real desktops

★ 39.2k starsApache-2.0
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

agent-lightning

Microsoft's trainer for AI agents - reinforcement learning for almost any agent framework

★ 18.6k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

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

Get UFO

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