[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72373":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":38,"readmeContent":39,"aiSummary":40,"trendingCount":16,"starSnapshotCount":16,"syncStatus":41,"lastSyncTime":42,"discoverSource":43},72373,"TuriX-CUA","TurixAI\u002FTuriX-CUA","TurixAI","This is the official website for TuriX Computer-use-Agent","https:\u002F\u002Fturix.ai",null,"Python",3056,309,25,4,0,9,18,121,27,96.47,"MIT License",false,"main",true,[27,28,29,30,31,32,33,34,35,36,37],"agent","ai-agents","browser-use","computer-automation","computer-use","computer-use-agent","cua","gui-agent","gui-operator","mcp","qwen3-vl","2026-06-12 04:01:04","\u003Cp align=\"center\">\n   \u003Cimg src=\".\u002Fdoc\u002FLogoHFitted.svg\" width=\"1600\" alt=\"TuriX logo\">\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">TuriX · Desktop Actions, Driven by AI\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\u003Cstrong>Talk to your computer, watch it work.\u003C\u002Fstrong>\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"README.md\">English\u003C\u002Fa> | \u003Ca href=\"README.zh-CN.md\">中文\u003C\u002Fa>\n\u003C\u002Fp>\n\n## 📞 Contact & Community\n\nJoin our Discord community for support, discussions, and updates:\n\n\u003Cp align=\"center\">\n   \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002FyaYrNAckb5\">\n      \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1400749393841492020?color=7289da&label=Join%20our%20Discord&logo=discord&logoColor=white&style=for-the-badge\" alt=\"Join our Discord\">\n   \u003C\u002Fa>\n\u003C\u002Fp>\n\nOr contact us with email: contact@turix.ai\n\nTuriX lets your powerful AI models take real, hands‑on actions directly on your desktop. \nIt ships with a **state‑of‑the‑art computer‑use agent** (achieves 80% success rate on our OSWorld‑style Mac benchmark and 64.2% success rate on OSWorld) yet stays 100 % open‑source and cost‑free for personal & research use.  \n\nPrefer your own model? **Change in `config.json` and go.**\n\n## Table of Contents\n- [📞 Contact & Community](#-contact--community)\n- [🤖 OpenClaw Skill](#-openclaw-skill)\n- [📰 Latest News](#-latest-news)\n- [🖼️ Demos](#️-demos)\n- [✨ Key Features](#-key-features)\n- [📊 Model Performance](#-model-performance)\n- [🚀 Quick‑Start (macOS 15+)](#-quickstart-macos-15)\n   - [1. Download the App](#1-download-the-app)\n   - [2. Create a Python 3.12 Environment](#2-create-a-python-312-environment)\n   - [3. Grant macOS Permissions](#3-grant-macos-permissions)\n      - [3.1 Accessibility](#31-accessibility)\n      - [3.2 Safari Automation](#32-safari-automation)\n   - [4. Configure & Run](#4-configure--run)\n   - [4.4 Skills (Optional)](#44-skills-optional)\n- [🤝 Contributing](#-contributing)\n- [🗺️ Roadmap](#️-roadmap)\n\n---\n\n## 🤖 OpenClaw Skill\n\nUse TuriX via OpenClaw with our published ClawHub skill:  \nhttps:\u002F\u002Fclawhub.ai\u002FTongyu-Yan\u002Fturix-cua\n\nThis repo also includes local OpenClaw skill packages in `OpenCLaw_TuriX_skill\u002F`:\n- macOS package in `main` (`SKILL.md` + `scripts\u002Frun_turix.sh`)\n- Windows package in `multi-agent-windows` (`SKILL.md` + `scripts\u002Frun_turix.ps1` + `agents\u002Fopenai.yaml`)\n\nFor installation and permissions, follow `OpenCLaw_TuriX_skill\u002FREADME.md`.\n\n---\n\n## 📰 Latest News\n\n**May 11, 2026** - Now can download **TuriX SuperAgent** from our [official web page](https:\u002F\u002Fturix.ai).\n\n**April 8, 2026** - 🚀 Introducing **TuriX SuperPower 3.0.0-alpha** for macOS (Apple Silicon)\n\nThis is our all-in-one productivity app that combines **TuriX CUA + CLI** in one workflow, and adds two new capabilities:\n- **TuriX-work** for everyday office execution and task orchestration\n- **TuriX-code** for coding, automation, and engineering tasks\n\nFrom writing code to handling office tasks, you can execute with CLI precision and close the loop through GUI actions in one continuous flow.\n\n**March 16, 2026** - 🐧 **Linux support is now available** on branch `multi-agent-linux`. If you want to run TuriX on Linux (for example Ubuntu), switch to that branch first:\n```bash\ngit checkout multi-agent-linux\n```\n\n**March 9, 2026** - Added a new **OpenClaw Flash\u002FFast Mode skill for macOS** on branch `mac_legacy`. If you want to use this faster, lighter setup, switch to that branch first:\n```bash\ngit checkout mac_legacy\n```\n\n**March 5, 2026** - Updated the **Windows OpenClaw local skill** on branch `multi-agent-windows` with direct dispatch, safer pre-flight checks, and the new `OpenCLaw_TuriX_skill\u002Fagents\u002Fopenai.yaml`.\n\n**Earlier updates (Jan 2026 and before)** - We shipped v0.3 (DuckDuckGo, Ollama, recoverable memory compression, Skills), published the TuriX OpenClaw skill on ClawHub, upgraded the core architecture to multi-model, and rolled out major model capability improvements including Qwen3-VL support and TuriX API model upgrades.\n\nReady to level up? Update your `config.json` and start automating—happy hacking! 🎉\n\n*Stay tuned to our [Discord](https:\u002F\u002Fdiscord.gg\u002FvkEYj4EV2n) for tips, user stories, and the next big drop.*\n\n---\n\n## 🖼️ Demos\n\u003Cp align=\"center\">\u003Cstrong>TuriX SuperPower App Demo\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp align=\"center\">\n   \u003Cimg src=\".\u002Fdoc\u002Fapp_demo.png\" width=\"1600\" alt=\"TuriX SuperPower app demo\">\n\u003C\u002Fp>\n\n\u003Ch3 align=\"center\">MacOS Demo\u003C\u002Fh3>\n\u003Cp align=\"center\">\u003Cstrong>Book a flight, hotel and uber.\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp align=\"center\">\n   \u003Cimg src=\".\u002Fdoc\u002Fbooking_demo.gif\" width=\"1600\" alt=\"TuriX macOS demo - booking\">\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\u003Cstrong>Search iPhone price, create Pages document, and send to contact\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp align=\"center\">\n   \u003Cimg src=\".\u002Fdoc\u002Fdemo1.gif\" width=\"1600\" alt=\"TuriX macOS demo - iPhone price search and document sharing\">\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\u003Cstrong>Generate a bar-chart in the numbers file sent by boss in discord and insert it to the right place of my powerpoint, and reply my boss.\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp align=\"center\">\n   \u003Cimg src=\".\u002Fdoc\u002Fcomplex_demo_mac.gif\" width=\"1600\" alt=\"TuriX macOS demo - excel graph to powerpoint\">\n\u003C\u002Fp>\n\n\u003Ch3 align=\"center\">Windows Demo\u003C\u002Fh3>\n\u003Cp align=\"center\">\u003Cstrong>Search video content in youtube and like it\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp align=\"center\">\n   \u003Cimg src=\".\u002Fdoc\u002Fwin_demo1.gif\" width=\"1600\" alt=\"TuriX Windows demo - video search and sharing\">\n\u003C\u002Fp>\n\n\u003Ch3 align=\"center\">MCP with Claude Demo\u003C\u002Fh3>\n\u003Cp align=\"center\">\u003Cstrong>Claude search for AI news, and call TuriX with MCP, write down the research result to a pages document and send it to contact\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp align=\"center\">\n   \u003Cimg src=\".\u002Fdoc\u002Fmcp_demo1.gif\" width=\"1600\" alt=\"TuriX MCP demo - news search and sharing\">\n\u003C\u002Fp>\n\n---\n\n## ✨ Key Features\n| Capability | What it means |\n|------------|---------------|\n| **SOTA default model** | Outperforms previous open‑source agents (e.g. UI‑TARS) on success rate and speed on Mac |\n| **No app‑specific APIs** | If a human can click it, TuriX can too—WhatsApp, Excel, Outlook, in‑house tools… |\n| **Hot‑swappable \"brains\"** | Replace the VLM policy without touching code (`config.json`) |\n| **MCP‑ready** | Hook up *Claude for Desktop* or **any** agent via the Model Context Protocol (MCP) |\n| **Skills (markdown playbooks)** | Planner selects relevant skill guides (name + description), brain uses full instructions to plan each step |\n\n---\n## 📊 Model Performance\n\nOur agent achieves state-of-the-art performance on desktop automation tasks:\n\n### OSWorld Benchmark — 3rd Place on the Leaderboard (50 Steps)\n\nTuriX scores **64.2% (229.88 \u002F 358)** on the full OSWorld benchmark, ranking **3rd overall** among all submitted agents. Notably, TuriX is built and optimized for **macOS**, where we achieve an **80%+ success rate** on our self-hosted OSWorld-style Mac benchmark. We used **zero Linux training data**, yet still achieve a top-3 finish on OSWorld's Linux-based environment.\n\n\u003Cp align=\"center\">\n   \u003Cimg src=\".\u002Fdoc\u002Fos-world.png\" width=\"600\" alt=\"TuriX OSWorld benchmark score — 64.2%\">\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n   \u003Cimg src=\".\u002Fdoc\u002Fperformance_sum.jpg\" width=\"1600\" alt=\"TuriX performance\">\n\u003C\u002Fp>\n\nFor more details, check our [report](https:\u002F\u002Fturix.ai\u002Ftechnical-report\u002F).\n\n## 🚀 Quick‑Start (macOS 15+)\n\n> **We never collect data**—install, grant permissions, and hack away.\n\n> **0. Windows Users**: Switch to the `multi-agent-windows` branch for Windows-specific setup and installation instructions.\n>\n> ```bash\n> git checkout multi-agent-windows\n> ```\n>\n> For the updated OpenClaw Windows local skill package, see `OpenCLaw_TuriX_skill\u002FREADME.md` in that branch.\n>\n> **0. Linux Users**: Switch to the `multi-agent-linux` branch for Linux-specific setup and installation instructions.\n>\n> ```bash\n> git checkout multi-agent-linux\n> ```\n>\n> **0. Windows Legacy Users**: For the previous Windows setup, switch to the `windows_legacy` branch.\n>\n> **0. macOS Legacy Users**: For the previous single-model macOS setup, switch to the `mac_legacy` branch.\n\n\n### 1. Download the App\nFor easier usage, [download the app](https:\u002F\u002Fturix.ai\u002F)\n\nOr follow the manual setup below:\n\n### 2. Create a Python 3.12 Environment\nFirstly Clone the repository and run:\n```bash\nconda create -n turix_env python=3.12\nconda activate turix_env        # requires conda ≥ 22.9\npip install -r requirements.txt\n```\n\n### 3. Grant macOS Permissions\n\n#### 3.1 Accessibility\n1. Open **System Settings ▸ Privacy & Security ▸ Accessibility**  \n2. Click **＋**, then add **Terminal** and **Visual Studio Code** ANY IDE you use\n3. If the agent still fails, also add **\u002Fusr\u002Fbin\u002Fpython3**\n\n#### 3.2 Safari Automation\n1. **Safari ▸ Settings ▸ Advanced** → enable **Show features for web developers**  \n2. In the new **Develop** menu, enable  \n    * **Allow Remote Automation**  \n    * **Allow JavaScript from Apple Events**  \n\n##### Trigger the Permission Dialogs (run once per shell)\n```\n# macOS Terminal\nosascript -e 'tell application \"Safari\" \\\nto do JavaScript \"alert(\\\"Triggering accessibility request\\\")\" in document 1'\n\n# VS Code integrated terminal (repeat to grant VS Code)\nosascript -e 'tell application \"Safari\" \\\nto do JavaScript \"alert(\\\"Triggering accessibility request\\\")\" in document 1'\n```\n\n> **Click \"Allow\" on every dialog** so the agent can drive Safari.\n\n### 4. Configure & Run\n\n#### 4.1 Edit Task Configuration\n\n> [!IMPORTANT]\n> **Task Configuration is Critical**: The quality of your task instructions directly impacts success rate. Clear, specific prompts lead to better automation results.\n\nEdit task in `examples\u002Fconfig.json`:\n```json\n{\n    \"agent\": {\n         \"task\": \"open system settings, switch to Dark Mode\"\n    }\n}\n```\n\n#### 4.2 Edit API Configuration\n\nGet API now with credit from our [official web page](https:\u002F\u002Fturix.ai\u002Fapi-platform\u002F).\nLogin to our website and the key is at the bottom.\n\nIn this main (multi-agent) branch, you need to set the brain, actor, and memory models. It only supports mac for now. If you enable planning\n(`agent.use_plan: true`), you also need to set the planner model.\nWe strongly recommand you to set the turix-actor model as the actor. The brain can be any VLMs you like, we provide qwen3.5vl in our platform. Gemini-3-pro is tested to be smartest, and Gemini-3-flash is fast and smart enough for most of the tasks. \n\nEdit API in `examples\u002Fconfig.json`:\n```json\n\"brain_llm\": {\n      \"provider\": \"turix\",\n      \"model_name\": \"turix-brain\",\n      \"api_key\": \"YOUR_API_KEY\",\n      \"base_url\": \"https:\u002F\u002Fturixapi.io\u002Fv1\"\n   },\n\"actor_llm\": {\n      \"provider\": \"turix\",\n      \"model_name\": \"turix-actor\",\n      \"api_key\": \"YOUR_API_KEY\",\n      \"base_url\": \"https:\u002F\u002Fturixapi.io\u002Fv1\"\n   },\n\"memory_llm\": {\n      \"provider\": \"turix\",\n      \"model_name\": \"turix-brain\",\n      \"api_key\": \"YOUR_API_KEY\",\n      \"base_url\": \"https:\u002F\u002Fturixapi.io\u002Fv1\"\n   },\n\"planner_llm\": {\n      \"provider\": \"turix\",\n      \"model_name\": \"turix-brain\",\n      \"api_key\": \"YOUR_API_KEY\",\n      \"base_url\": \"https:\u002F\u002Fturixapi.io\u002Fv1\"\n   }\n```\n\nFor a local Ollama setup, point each role to your Ollama server:\n```json\n\"brain_llm\": {\n      \"provider\": \"ollama\",\n      \"model_name\": \"llama3.2-vision\",\n      \"base_url\": \"http:\u002F\u002Flocalhost:11434\"\n   },\n\"actor_llm\": {\n      \"provider\": \"ollama\",\n      \"model_name\": \"llama3.2-vision\",\n      \"base_url\": \"http:\u002F\u002Flocalhost:11434\"\n   },\n\"memory_llm\": {\n      \"provider\": \"ollama\",\n      \"model_name\": \"llama3.2-vision\",\n      \"base_url\": \"http:\u002F\u002Flocalhost:11434\"\n   },\n\"planner_llm\": {\n      \"provider\": \"ollama\",\n      \"model_name\": \"llama3.2-vision\",\n      \"base_url\": \"http:\u002F\u002Flocalhost:11434\"\n   }\n```\n\n#### 4.3 Configure Custom Models (Optional)\n\nIf you want to use other models not defined by the build_llm function in the main.py, you need to first define it, then setup the config.\n\nmain.py:\n\n```\nif provider == \"name_you_want\":\n        return ChatOpenAI(\n            model=\"gpt-4.1-mini\", api_key=api_key, temperature=0.3\n        )\n```\nSwitch between ChatOpenAI, ChatGoogleGenerativeAI, ChatAnthropic, or ChatOllama base on your llm. Also change the model name.\n\n#### 4.4 Skills (Optional)\n\nSkills are lightweight markdown playbooks stored in a single folder (default: `skills\u002F`). Each skill file starts with YAML frontmatter containing `name` and `description`, followed by the instructions. The planner only sees the name + description to select relevant skills; the brain receives the full skill content to guide step goals.\nSkills selection requires planning (`agent.use_plan: true`).\n\nExample skill file (`skills\u002Fgithub-web-actions.md`):\n```md\n---\nname: github-web-actions\ndescription: Use when navigating GitHub in a browser (searching repos, starring, etc.).\n---\n# GitHub Web Actions\n- Open GitHub, use the site search, and navigate to the repo page.\n- If login is required, ask the user before proceeding.\n- Confirm the Star button state before moving on.\n```\n\nEnable in `examples\u002Fconfig.json`:\n```json\n{\n  \"agent\": {\n    \"use_plan\": true,\n    \"use_skills\": true,\n    \"skills_dir\": \"skills\",\n    \"skills_max_chars\": 4000\n  }\n}\n```\n\n#### 4.5 Start the Agent\n\n```bash\npython examples\u002Fmain.py\n```\n\n**Enjoy hands‑free computing 🎉**\n\n#### 4.6 Resume a Terminated Task\n\nTo resume a task after an interruption, set a stable `agent_id` and enable `resume` in `examples\u002Fconfig.json`:\n```json\n{\n    \"agent\": {\n         \"resume\": true,\n         \"agent_id\": \"my-task-001\"\n    }\n}\n```\nNotes:\n- Use the same `agent_id` as the run you want to resume.\n- Keep the same `task` when resuming.\n- Resume only works if prior memory exists at `src\u002Fagent\u002Ftemp_files\u002F\u003Cagent_id>\u002Fmemory.jsonl`.\n- To start fresh, set `resume` to `false`, change `agent_id`, or delete `src\u002Fagent\u002Ftemp_files\u002F\u003Cagent_id>`.\n\n## 🤝 Contributing\n\nWe welcome contributions! Please read our [Contributing Guide](CONTRIBUTING.MD) to get started.\n\nQuick links:\n- [Development Setup](CONTRIBUTING.MD#development-setup)\n- [Code Style Guidelines](CONTRIBUTING.MD#code-style-guidelines)\n- [Testing](CONTRIBUTING.MD#testing)\n- [Pull Request Process](CONTRIBUTING.MD#pull-request-process)\n\nFor bug reports and feature requests, please [open an issue](https:\u002F\u002Fgithub.com\u002FTurixAI\u002FTuriX-CUA\u002Fissues).\n\n[![MseeP.ai Security Assessment Badge](https:\u002F\u002Fmseep.net\u002Fpr\u002Fturixai-turix-cua-badge.png)](https:\u002F\u002Fmseep.ai\u002Fapp\u002Fturixai-turix-cua)\n","TuriX CUA 是一个基于人工智能的桌面操作代理，能够通过对话方式控制计算机执行任务。该项目的核心功能是利用先进的AI模型直接在用户的桌面上进行实际操作，支持高达80%的成功率（针对Mac OSWorld风格基准）和64.2%的成功率（针对OSWorld）。技术上，TuriX CUA 使用Python编写，并保持完全开源免费供个人及研究使用。用户还可以根据需要自定义使用的AI模型。此工具非常适合需要自动化日常办公、编程或网页浏览等任务的场景，特别是对于希望通过自然语言命令来简化工作流程的用户。",2,"2026-06-11 03:41:32","high_star"]