🪟 Windows-Use

Windows-Use is a powerful automation agent that interact directly with the Windows at GUI layer. It bridges the gap between AI Agents and the Windows OS to perform tasks such as opening apps, clicking buttons, typing, executing shell commands, and capturing UI state all without relying on traditional computer vision models. Enabling any LLM to perform computer automation instead of relying on specific models for it.

• Python 3.12 or higher
• UV (or pip)
• Windows 7 or 8 or 10 or 11

Install using uv:

uv pip install windows-use

Or with pip:

pip install windows-use

from langchain_google_genai.chat_models import ChatGoogleGenerativeAI
from windows_use.agent import Agent, Browser
from dotenv import load_dotenv
import os

load_dotenv()

def main():
    llm = ChatGoogleGenerativeAI(model='gemini-2.5-flash', temperature=0.2)
    agent = Agent(llm=llm, browser=Browser.EDGE, use_vision=False, auto_minimize=True)
    agent.print_response(query=input("Enter a query: "))

if __name__ == "__main__":
    main()

from langchain_cerebras.chat_models import ChatCerebras
from windows_use.agent import Agent, Browser
from dotenv import load_dotenv
import os

load_dotenv()

def main():
    llm=ChatCerebras(api_key=os.getenv("CEREBRAS_API_KEY"), model="gpt-oss-120b", temperature=0.2)
    agent = Agent(llm=llm, browser=Browser.EDGE, use_vision=False, auto_minimize=True)
    agent.print_response(query=input("Enter a query: "))

if __name__ == "__main__":
    main()

from windows_use.llm.openrouter import ChatOpenRouter
from windows_use.agent import Agent, Browser
from dotenv import load_dotenv
import os

load_dotenv()

def main():
    api_key=os.getenv("OPENROUTER_API_KEY")
    llm = ChatOpenRouter(model="openai/gpt-4o",api_key=api_key)
    agent = Agent(llm=llm, browser=Browser.EDGE, use_vision=False, auto_minimize=True)
    agent.print_response(query=input("Enter a query: "))

if __name__ == "__main__":
    main()

You can use the following to run from a script:

python main.py

PROMPT: Write a short note about LLMs and save to the desktop

PROMPT: Change from Dark mode to Light mode

Talk to your computer. Watch it get things done.

Agent interacts directly with your Windows OS at GUI layer to perform actions. While the agent is designed to act intelligently and safely, it can make mistakes that might bring undesired system behaviour or cause unintended changes. Try to run the agent in a sandbox envirnoment.

This project is licensed under the MIT License - see the LICENSE file for details.

Windows-Use makes use of several excellent open-source projects that power its Windows automation features:

• UIAutomation

• PyAutoGUI

Huge thanks to the maintainers and contributors of these libraries for their outstanding work and open-source spirit.

Contributions are welcome! Please check the CONTRIBUTING file for setup and development workflow.

Made with ❤️ by Jeomon George

@software{
  author       = {George, Jeomon},
  title        = {Windows-Use: Enable AI to control Windows OS},
  year         = {2025},
  publisher    = {GitHub},
  url={https://github.com/CursorTouch/Windows-Use}
}