mac-use

本项目允许您原生控制 macOS，通过原生 macOS 命令和实用程序提供直接的系统控制。

[!CAUTION] 这存在明显的风险。Anthropic 代理可以控制您 Mac 上的所有内容。请务必小心。

功能

• 原生 macOS GUI 交互（无需 Docker）
• 使用原生 macOS 命令进行屏幕截图
• 通过 cliclick 控制键盘和鼠标
• 支持多种 LLM 提供商（Anthropic、Bedrock、Vertex）
• 基于 Streamlit 的界面
• 自动屏幕分辨率缩放
• 文件系统交互和编辑功能

前提条件

• macOS Sonoma 15.7 或更高版本
• Python 3.12+
• Homebrew（用于安装其他依赖项）
• cliclick (brew install cliclick) - 控制鼠标和键盘的必需项

安装说明

1. 克隆存储库并导航到它：

git clone https://github.com/hanzoai/mac-use.git
cd mac-use

2. 创建并激活虚拟环境：

python3.12 -m venv venv
source venv/bin/activate

3. 运行安装脚本：

chmod +x setup.sh
./setup.sh

4. 安装 Python 依赖项：

pip install -r requirements.txt

运行演示

设置您的环境和 Anthropic API 密钥

1. 在 .env 文件中添加：

API_PROVIDER=anthropic
ANTHROPIC_API_KEY=<key>
WIDTH=800
HEIGHT=600
DISPLAY_NUM=1

设置屏幕尺寸（建议：保持在 XGA/WXGA 分辨率范围内），并从 Anthropic Console 中输入您的密钥。

2. 启动 Streamlit 应用程序：

streamlit run streamlit.py

该界面将在 http://localhost:8501 上可用

屏幕尺寸注意事项

我们建议使用以下分辨率之一以获得最佳性能：

• XGA：1024x768 (4:3)
• WXGA：1280x800 (16:10)
• FWXGA：1366x768 (~16:9)

更高的分辨率将自动缩小到这些目标，以优化模型性能。您可以使用环境变量设置分辨率：

export WIDTH=1024
export HEIGHT=768
streamlit run streamlit.py

[!IMPORTANT] 此参考实现中使用的 Beta API 可能会发生更改。有关最新信息，请参阅 API 发行说明。