TuriX快速开始教程10分钟安装自动完成第一个桌面自动化任务附常见问题【免费下载链接】TuriX-CUAThis is the official website for TuriX Computer-use-Agent项目地址: https://gitcode.com/gh_mirrors/tu/TuriX-CUATuriX是一款 100% 开源免费的AI 桌面自动化工具Computer-Use-Agent计算机使用智能体。你只需要用一句话描述任务它就能像人一样打开应用、点击按钮、输入文字帮你自动完成 macOS 桌面操作。本教程带你10 分钟完成 TuriX 安装并跑通你的第一个桌面自动化任务。TuriX 是什么为什么说它强大TuriX 的核心思路是Talk to your computer, watch it work——把任务说给你的电脑然后看着它干活。它的四大亮点特性说明 先进模型在 OSWorld 基准测试中位列第 3macOS 自建基准成功率超 80%️ 无需专用 API只要人能点的它就能点——Excel、Outlook、内部工具都行 大脑可热插拔在 examples/config.json 里切换模型无需改代码 支持 Skills用 Markdown 手册教会 Agent 特定场景的操作套路下图是 TuriX 一体化应用的演示可以看到它如何接管桌面执行任务开始前环境要求与分支选择系统要求macOS 15 及以上main分支当前主要支持 macOSLinux 用户切换到multi-agent-linux分支Windows 用户切换到multi-agent-windows分支依赖要求Python3.12推荐用 conda 管理版本 ≥ 22.9依赖清单见 requirements.txt一步克隆仓库并创建 Python 3.12 环境在终端执行以下命令克隆 TuriX 仓库并搭建独立的 Python 环境git clone https://gitcode.com/gh_mirrors/tu/TuriX-CUA cd TuriX-CUA conda create -n turix_env python3.12 conda activate turix_env pip install -r requirements.txt 如果你更想省事也可以直接到 TuriX 官方网页下载打包好的应用跳过手动安装。二步正确授予 macOS 三大权限最容易踩坑macOS 的安全机制要求显式授权漏配任何一项都会导致任务启动失败。1️⃣ 屏幕录制权限系统设置 ▸ 隐私与安全性 ▸ 屏幕录制添加并开启TerminalVisual Studio Code或你使用的 IDE启动入口 examples/main.py 会在运行前自动检查该权限源码has_screen_capture_permission()见 examples/main.py。2️⃣ 辅助功能权限系统设置 ▸ 隐私与安全性 ▸ 辅助功能点击添加Terminal和VS Code若仍失败再添加/usr/bin/python33️⃣ Safari 自动化权限需要操作浏览器时Safari ▸ 设置 ▸ 高级→ 开启显示针对 Web 开发者的功能在新出现的开发菜单中启用允许远程自动化和允许来自 Apple Events 的 JavaScript在终端运行一次下面的命令触发权限弹窗点击允许osascript -e tell application Safari to do JavaScript alert(1) in document 1三步配置模型写下第一个任务编辑 API 配置打开 examples/config.json需要配置 4 个模型角色这是 TuriX 多智能体架构的核心brain_llm理解任务、制定步骤目标actor_llm执行精确的 UI 点击/输入动作planner_llm规划与技能选择开启use_plan时需要memory_llm跨步骤保持上下文记忆你可以使用官方turixprovider也可以指向本地 Ollama比如llama3.2-vision或其他兼容 OpenAI 接口的服务brain_llm: { provider: ollama, model_name: llama3.2-vision, base_url: http://localhost:11434 }其余角色同理。模型热插拔能力由 examples/main.py 中的build_llm函数实现支持turix、ollama、deepseek、kimi、gpt、anthropic等多种 provider。写下你的任务⚠️任务描述的质量直接决定成功率。清晰、具体的提示 更好的自动化效果。把 examples/config.json 中的agent.task改成你的一句话任务例如task: open system settings, switch to Dark Mode启动Agent见证第一个桌面自动化任务完成一切就绪后执行python examples/main.pyAgent 启动后会自动截取屏幕、规划步骤、驱动鼠标键盘完成任务。下面这个演示中TuriX 自动查询 iPhone 价格、创建 Pages 文档并发送给联系人——全程无需你碰一下鼠标 如果任务跑偏了按CmdShift2由force_stop_hotkey配置可立即强制停止。 执行日志保存在.turix_tmp/logging.log可以随时tail -f查看每一步的推理过程。进阶玩法多步预订任务与 Skills 技能系统更复杂的多步任务当它预订机票、酒店和 Uber 时你就知道什么叫数字牛马了用 Skills 让 Agent 更懂你的场景Skills 是放在 skills/ 目录下的 Markdown 手册。仓库内置了一个示例skills/github-web-actions.md它教 Agent 如何规范地在浏览器中搜索仓库、点 Star、遇到登录先询问用户。机制很简单Planner 只读取技能的 name description 来挑选技能Brain 则读取完整内容指导每一步。在配置中启用agent: { use_plan: true, use_skills: true, skills_dir: skills }你也可以照葫芦画瓢为自己的高频场景浏览器表单、内部系统操作写一个专属技能文件建议控制在 4000 字符以内。Windows 用户同样可以玩切换到multi-agent-windows分支后Windows 上同样能体验例如下面这个自动搜索视频并点赞的演示常见问题 FAQ Q1报错AttributeError: NoneType object has no attribute save怎么办这是典型的屏幕录制权限缺失。按上文二步把 Terminal / IDE 加入屏幕录制权限列表然后重启终端再运行。Q2任务中途断网/被中断了能接着跑吗可以。在 examples/config.json 中设置固定的agent_id并开启resume: true就会从src/agent/temp_files/agent_id/memory.jsonl保存的记忆处继续。注意恢复时task需保持一致。Q3能用自己的模型吗必须用官方模型吗不必须。TuriX 主打大脑可热插拔——在 examples/config.json 中把各*_llm的provider改为ollama、gpt、deepseek等即可参见 examples/main.py。想接入未内置的服务商在build_llm中加几行定义即可。Q4第一次运行为什么感觉特别慢首次启动需要加载 Brain、Actor、Planner、Memory 全部 AI 模型通常需要2~5 分钟属正常现象。Q5权限添加了但不生效把该应用/二进制从权限列表中移除后重新添加并确认开关是打开状态列表里找不到目标文件时在文件选择器中按CmdShiftG手动粘贴完整路径如/usr/bin/python3。Q6任务描述写什么效果好✅ 推荐Open Safari, go to google.com, search for TuriX AI, and click the first result ❌ 避免帮我弄一下、修复这个问题 这类模糊指令。具体到目标应用 明确步骤效果最好。写在最后 至此你已经完成了TuriX 安装并跑通了第一个桌面自动化任务。回顾一下完整路径克隆仓库 Python 3.12 环境2 分钟授予屏幕录制、辅助功能、Safari 三大权限3 分钟在 examples/config.json 配置模型与任务3 分钟python examples/main.py见证桌面被自动接管2 分钟TuriX 100% 开源、不收集数据个人与科研用途免费。快去给它布置第一个差事吧——比如打开系统设置切换到深色模式。更多架构细节可以探索 src/agent/service.pyAgent 核心循环与 src/controller/service.py动作控制器也欢迎参考 CONTRIBUTING.MD 为项目贡献代码【免费下载链接】TuriX-CUAThis is the official website for TuriX Computer-use-Agent项目地址: https://gitcode.com/gh_mirrors/tu/TuriX-CUA创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
