# Windows-Use

**Repository Path**: crazymonkey186/Windows-Use

## Basic Information

- **Project Name**: Windows-Use
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-11
- **Last Updated**: 2025-08-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

  <h1>🪟 Windows-Use</h1>
  <a href="https://pepy.tech/project/windows-use">
    <img src="https://static.pepy.tech/badge/windows-use" alt="PyPI下载量">
  </a>
  <a href="https://github.com/CursorTouch/windows-use/blob/main/LICENSE">
    <img src="https://img.shields.io/badge/license-MIT-green" alt="许可证">
  </a>
  <img src="https://img.shields.io/badge/python-3.12%2B-blue" alt="Python版本">
  <img src="https://img.shields.io/badge/platform-Windows%207–11-blue" alt="支持平台: Windows 7至11">
  <br>

  <a href="https://x.com/CursorTouch">
    <img src="https://img.shields.io/badge/follow-%40CursorTouch-1DA1F2?logo=twitter&style=flat" alt="在Twitter上关注">
  </a>
  <a href="https://discord.com/invite/Aue9Yj2VzS">
    <img src="https://img.shields.io/badge/加入-Discord-5865F2?logo=discord&logoColor=white&style=flat" alt="加入Discord社区">
  </a>

</div>

<br>

**Windows-Use** 是一个强大的自动化代理，能够在GUI层面直接与Windows系统交互。它架起了AI代理与Windows操作系统之间的桥梁，可以执行打开应用程序、点击按钮、输入文本、执行shell命令和捕获UI状态等任务，而无需依赖传统的计算机视觉模型。这使得任何LLM都能执行计算机自动化，而不必依赖特定的模型。

## 🛠️安装指南

### **前提条件**

- Python 3.12或更高版本
- [UV](https://github.com/astral-sh/uv)（或`pip`）
- Windows 7、8、10或11

### **安装步骤**

**使用`uv`安装：**

```bash
uv pip install windows-use
````

或使用pip：

```bash
pip install windows-use
```

## ⚙️基本用法

```python
# main.py
from langchain_google_genai import ChatGoogleGenerativeAI
from windows_use.agent import Agent
from dotenv import load_dotenv

load_dotenv()

llm=ChatGoogleGenerativeAI(model='gemini-2.0-flash')
agent = Agent(llm=llm,browser='chrome',use_vision=True)
query=input("输入您的查询: ")
agent_result=agent.invoke(query=query)
print(agent_result.content)
```

## 🤖 运行代理

您可以使用以下命令从脚本运行：

```bash
python main.py
输入您的查询: <您的任务>
```

---

## 🎥 演示

**提示:** 写一篇关于LLM的简短说明并保存到桌面

<https://github.com/user-attachments/assets/0faa5179-73c1-4547-b9e6-2875496b12a0>

**提示:** 从深色模式切换到浅色模式

<https://github.com/user-attachments/assets/47bdd166-1261-4155-8890-1b2189c0a3fd>

## 📈 基础架构

![图片](https://github.com/user-attachments/assets/e1d32725-e28a-4821-9c89-24b5ba2e583f)
![图片](https://github.com/user-attachments/assets/be72ad43-c320-4831-95cf-6f1f30df18de)
![图片](https://github.com/user-attachments/assets/d91b513e-13a0-4451-a6e9-f1e16def36e3)
![图片](https://github.com/user-attachments/assets/b5ef5bcf-0e15-4c87-93fe-0f9a983536e5)
![图片](https://github.com/user-attachments/assets/2b5cada6-4ca1-4e0c-8a10-2df29911b1cb)

## 愿景

与您的计算机对话，看着它完成任务。

## 星标历史

[![星标历史图表](https://api.star-history.com/svg?repos=CursorTouch/Windows-Use&type=Date)](https://www.star-history.com/#CursorTouch/Windows-Use&Date)

## ⚠️ 注意事项

代理直接在GUI层与Windows操作系统交互以执行操作。虽然代理设计为智能且安全地运行，但它可能会出错，可能导致不期望的系统行为或意外更改。尝试在沙箱环境中运行代理。

## 🪪 许可证

本项目采用MIT许可证 - 详见[LICENSE](LICENSE)文件了解详情。

## 🤝 贡献

欢迎贡献！请查看[CONTRIBUTING](CONTRIBUTING)文件了解设置和开发工作流程。

由[Jeomon George](https://github.com/Jeomon) 用心制作

---

## 引用

```bibtex
@software{
  author       = {George, Jeomon},
  title        = {Windows-Use: 让AI能够控制Windows操作系统},
  year         = {2025},
  publisher    = {GitHub},
  url={https://github.com/CursorTouch/Windows-Use}
}
```