v0.8.1

What's new

• Fix missing self.extra_body in ChatOpenAI causing AttributeError for subclasses (ChatNvidia, ChatDeepSeek)
• Add thinking: bool parameter to ChatVLLM, injecting enable_thinking via extra_body on all create calls
• reasoning_effort parameter added to ChatOpenAI and ChatDeepSeek

v0.8.0

What's new

• Fix missing self.extra_body in ChatOpenAI causing AttributeError for subclasses (ChatNvidia, ChatDeepSeek)
• Add thinking: bool parameter to ChatVLLM, injecting enable_thinking via extra_body on all create calls
• reasoning_effort parameter added to ChatOpenAI and ChatDeepSeek

v0.7.9

• Fix missing self.extra_body in ChatOpenAI causing AttributeError for subclasses (ChatNvidia, ChatDeepSeek)
• Add thinking: bool parameter to ChatVLLM, injecting enable_thinking via extra_body on all create calls

v0.7.7

What's Changed

Features

• Add loop detection to prevent agent from repeating stuck behaviors
• Add disable_loop_detection parameter to Agent
• Add base_url configuration support for LLM providers
• Add custom model support for all CLI providers
• Add Perplexity provider support
• Add SelectorMap for label-to-element lookup
• Wire hwnd into tree traversal for cursor-free element resolution
• Handle collapsable patterns on GroupControl as interactive
• Implement context compaction to handle long-running tasks
• Document control added to tree config

Improvements

• Optimize UIA tree caching to minimize redundant COM calls
• Add typed UIA exception hierarchy and dead-window fast-exit
• Convert UIA IDs to enums
• Refactor SelectorMap as index-to-node mapping
• Set wait times for UIA operations

Bug Fixes

• Fix UnicodeDecodeError caused by GBK locale encoding in PowerShell output — forces UTF-8 output from PowerShell regardless of system locale
• Fix TokenUsage validation error and SyntaxWarning in get_screenshot
• Fix custom xpath root resolution

v0.7.66

What's Changed

Added

• Telemetry: Agent now sends structured agent_event data to PostHog on every invoke/ainvoke call, capturing query, steps, model, provider, success/failure, and error details. Runs silently with no console output.
• Public API: Agent, Browser, AgentEvent, EventType, BaseEventSubscriber and friends are now importable directly from windows_use:

  from windows_use import Agent, Browser

• CI/CD: GitHub Actions workflows for linting and tests on Windows across Python 3.10–3.13, plus automated PyPI publishing on version tags.

Fixed

• Tree traversal: NoneType crashes when Windows UI Automation returns None for element names — fixed across 6 locations in tree traversal.
• Event system: ValueError: list.remove(x): x not in list when removing an event subscriber that was already removed or never added.
• Telemetry user ID: PermissionError on systems where TEMP points to C:\WINDOWS\TEMP — now uses tempfile.gettempdir().

Installation

pip install windows-use==0.7.66

uv add windows-use==0.7.66