ui-focused desktop task automation via visual perception and llm reasoning
UFO² captures Windows desktop screenshots, annotates UI controls with bounding boxes and accessibility metadata, and uses LLM reasoning to decompose natural language tasks into sequences of UI interactions (clicks, text input, keyboard commands). The Host Agent orchestrates high-level task planning while App Agents execute granular actions within specific applications, maintaining state machines to track progress and handle failures across multi-step workflows.
Unique: Dual-agent architecture (Host Agent for task decomposition + App Agents for application-specific execution) with state machines that track agent lifecycle, enabling recovery from failures and context persistence across application boundaries. Uses hybrid action system combining LLM-driven decisions with deterministic COM automation for precise control.
vs alternatives: Outperforms traditional RPA tools (UiPath, Blue Prism) by reasoning about UI semantically rather than recording playback sequences, enabling adaptation to UI variations; faster than pure vision-based agents (like some computer vision RPA) by leveraging Windows Accessibility API metadata alongside screenshots.
multi-modal screenshot annotation and ui control extraction
UFO² captures full desktop screenshots and overlays bounding boxes with unique IDs for every interactive UI control (buttons, text fields, dropdowns, etc.) extracted via Windows Accessibility API (UIA) and COM object inspection. Annotations include control type, label, state, and accessibility properties, creating a structured representation of the UI that LLMs can reason about without OCR. The system handles dynamic UI updates by re-capturing and re-annotating on each agent round.
Unique: Combines Windows Accessibility API (UIA) metadata extraction with visual bounding box annotation, creating a hybrid representation that avoids pure OCR brittleness while preserving visual grounding. Assigns stable control IDs that persist across rounds, enabling agents to reference controls consistently even as pixel coordinates shift.
vs alternatives: More reliable than pure vision-based UI understanding (e.g., Claude's vision API alone) because it leverages structured accessibility metadata; faster than OCR-based approaches because it extracts control properties without character-level text recognition.
llm provider abstraction with multi-provider support and structured output
UFO² abstracts LLM interactions behind a provider-agnostic interface supporting OpenAI, Anthropic, Azure OpenAI, and local Ollama models. The system handles provider-specific details (API authentication, request formatting, response parsing) transparently. For structured outputs, UFO² uses JSON schema validation and function calling APIs (where available) to ensure agents produce well-formed action specifications. Supports custom model integration via a plugin interface.
Unique: Provider-agnostic LLM interface abstracting OpenAI, Anthropic, Azure OpenAI, and Ollama with unified structured output handling via JSON schema validation and function calling. Enables seamless provider switching and custom model integration.
vs alternatives: More flexible than provider-specific SDKs because it abstracts away provider differences; more robust than direct API calls because it handles retries, rate limiting, and structured output validation transparently.
configuration-driven agent and deployment customization
UFO² uses YAML/JSON configuration files to define agent behavior, LLM settings, tool definitions, and deployment modes without code changes. Configuration includes agent type (Host/App), LLM provider and model, prompt templates, tool definitions, knowledge base paths, and deployment mode (local, service, or Galaxy). The system loads configurations at startup and applies them consistently across all agent instances, enabling rapid experimentation and deployment variations.
Unique: Configuration-driven approach where agent behavior, LLM settings, tools, and deployment modes are defined in YAML/JSON files, enabling rapid experimentation and deployment variations without code changes. Supports multiple deployment modes (local, service, Galaxy) via configuration.
vs alternatives: More flexible than hardcoded agent logic because settings can be changed without recompilation; more accessible than code-based configuration because non-technical users can modify YAML files.
galaxy web ui for multi-device task monitoring and control
UFO³ Galaxy Framework includes a web-based UI for monitoring and controlling multi-device automation. The UI displays registered devices, running tasks, execution traces, and device health metrics. Users can submit new tasks, view real-time execution progress (including screenshots from remote devices), inspect action history, and manage device lifecycle (register, deregister, restart). The UI communicates with the Galaxy controller via REST APIs or WebSockets for real-time updates.
Unique: Web-based monitoring and control UI for Galaxy Framework, displaying device status, task execution traces, and real-time screenshots from remote devices. Enables centralized management of multi-device automation fleets.
vs alternatives: More user-friendly than command-line tools because it provides visual feedback and real-time updates; more comprehensive than basic logging because it shows device health, task dependencies, and execution traces in a unified interface.
state machine-based agent lifecycle and error recovery
UFO² agents implement explicit state machines defining valid state transitions (e.g., Idle → Planning → Executing → Observing → Idle). Each agent round transitions through states, with state-specific logic for handling errors, retries, and recovery. If an action fails, the agent can retry within the same Round, escalate to the Host Agent, or transition to an error recovery state. State machines enable deterministic behavior, clear error handling, and recovery strategies without ad-hoc exception handling.
Unique: Explicit state machines for agent lifecycle (Idle → Planning → Executing → Observing) with state-specific error handling and recovery logic. Enables deterministic behavior and clear error recovery without ad-hoc exception handling.
vs alternatives: More predictable than event-driven agents because state transitions are explicit; more maintainable than exception-based error handling because recovery strategies are state-specific and testable.
host agent and app agent hierarchical task decomposition
UFO² implements a two-tier agent hierarchy where the Host Agent receives natural language tasks, decomposes them into sub-tasks, and delegates execution to specialized App Agents running within specific application contexts. Each App Agent maintains its own state machine, action history, and application-specific knowledge, communicating results back to the Host Agent. The Host Agent orchestrates task flow, handles inter-application dependencies, and decides when to switch between App Agents or retry failed sub-tasks.
Unique: Implements explicit Host/App Agent separation with state machines for each tier, allowing Host Agent to reason about task-level dependencies while App Agents handle application-specific control flow. Each agent maintains its own action history and context window, enabling independent reasoning without monolithic context bloat.
vs alternatives: More structured than flat multi-agent systems (e.g., AutoGPT-style agent pools) because it enforces hierarchical task decomposition; more flexible than rigid workflow engines (e.g., UiPath) because agents reason about task structure dynamically rather than following pre-recorded sequences.
session and round-based execution lifecycle management
UFO² organizes execution into Sessions (long-lived contexts for a task) and Rounds (individual agent decision cycles). Each Round captures the current UI state (screenshot + annotations), executes one or more actions, observes results, and feeds observations back to the agent for the next Round. Sessions maintain action history, context windows, and error recovery state across multiple Rounds, enabling agents to learn from previous attempts and adapt strategies.
Unique: Explicit Round abstraction that captures UI state, executes actions, and observes outcomes in a single atomic unit, with Sessions aggregating Rounds into coherent task executions. Enables agents to maintain action history and context across Rounds without losing intermediate state.
vs alternatives: More structured than continuous agent loops (e.g., ReAct agents without explicit round boundaries) because it enforces state capture at each decision point; more transparent than black-box automation tools because every Round is logged and inspectable.
+6 more capabilities