Mac Use

🚀 Overlord——掌控你的 Mac 設備

Overlord 是一個基於本地計算機的 AI 項目，它藉助 macOS 本機命令和工具，實現對 macOS 系統的直接控制，為你帶來便捷的系統操控體驗。

⚠️ 重要提示

該項目存在明顯風險。Overlord 可以完全控制你的 Mac。請謹慎操作。

✨ 主要特性

• 原生 macOS 圖形界面交互（無需 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/overlord.git
cd overlord

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 控臺 獲取的密鑰。 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

⚠️ 重要提示

此參考實現中使用的 Beta API 可能會更改。請參考API 發佈說明獲取最新信息。