<img src="./doc/LogoHFitted.svg" width="1600" alt="TuriX logo"> <h1 align="center">TuriX · Desktop Actions, Driven by AI</h1> Talk to your computer, watch it work. <a href="README.md">English</a> | <a href="README.zh-CN.md">中文</a>

📞 Contact & Community

Join our Discord community for support, discussions, and updates:

Or contact us with email: contact@turix.ai

TuriX lets your powerful AI models take real, hands‑on actions directly on your desktop. It ships with a state‑of‑the‑art computer‑use agent (passes > 68 % of our internal OSWorld‑style test set) yet stays 100 % open‑source and cost‑free for personal & research use.

Prefer your own model? Change in config.json and go.

📞 Contact & Community
🤖 OpenClaw Skill
📰 Latest News
🖼️ Demos
✨ Key Features
📊 Model Performance
🚀 Quick‑Start (macOS 15+)
🤝 Contributing
🗺️ Roadmap

🤖 OpenClaw Skill

Use TuriX via OpenClaw with our published skill on ClawHub:
https://clawhub.ai/Tongyu-Yan/turix-cua
This lets OpenClaw call TuriX so it can act as your desktop agent.

Local OpenCLaw skill (macOS): this repo also includes a ready-to-use skill package in OpenCLaw_TuriX_skill/ (SKILL.md + scripts/run_turix.sh).
Copy it into your OpenClaw local skills folder (for example: clawd/skills/local/turix-mac/) and follow OpenCLaw_TuriX_skill/README.md for setup and permissions.

Local OpenClaw skill (Windows): on branch multi-agent-windows, OpenCLaw_TuriX_skill/ is updated for Windows with SKILL.md, scripts/run_turix.ps1, and agents/openai.yaml.
This update adds direct dispatch via turix (alias turix-win) in the current OpenClaw session, plus pre-flight checks in run_turix.ps1 (required branch multi-agent-windows, conda/config validation, and --dry-run support). You can also instruct OpenClaw directly: read OpenCLaw_TuriX_skill/README.md first, then install and configure TuriX.

📰 Latest News

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:

git checkout multi-agent-linux

March 9, 2026 - Added a new OpenClaw Flash/Fast Mode skill for macOS on branch mac_legacy. If you want to use this faster, lighter setup, switch to that branch first:

git checkout mac_legacy

March 5, 2026 - Updated the Windows OpenClaw local skill on branch multi-agent-windows. This update adds a user-invocable turix skill alias, direct dispatch without requiring a Turix sub-session, branch-safe pre-flight checks in run_turix.ps1, and the new agent interface file OpenCLaw_TuriX_skill/agents/openai.yaml.

January 30, 2026 - 🧩 We published the TuriX OpenClaw Skill on ClawHub: https://clawhub.ai/Tongyu-Yan/turix-cua. You can now use OpenClaw to call TuriX and automate desktop tasks.

January 27, 2026 — v0.3 - 🎉 TuriX v0.3 is now live on the main branch! This release brings DuckDuckGo search, Ollama support, advanced recoverable memory compression, and Skills—unlocking smarter planning, more resilient memory, and reusable workflows for desktop automation. We’re excited to see more users try it out and share feedback as we keep pushing the platform forward.

January 27, 2026 - 🎉 We released Recoverable Memory Compression and Skills in the multi-agent and multi-agent-windows branches. These features add more stable memory handling and reusable markdown playbooks for task planning.

January 27, 2026 - 🎉 We released Recoverable Memory Compression and Skills in the main (formerly multi-agent) and multi-agent-windows branches. These features add more stable memory handling and reusable markdown playbooks for task planning.

December 30, 2025 - 🎉 Significant update in Agent Archetecture. We introduce a multi-model archetecture in the main (formerly multi-agent) branch, releasing the stress from a single model to multiple models.

October 16, 2025 - 🚀 Big news for automation enthusiasts! TuriX now fully supports the cutting-edge Qwen3-VL vision-language model, empowering seamless PC automation across both macOS and Windows. This integration boosts task success rates by up to 15% on complex UI interactions (based on our internal benchmarks), making your desktop workflows smarter and faster than ever. Whether you're scripting daily routines or tackling intricate projects, Qwen3-VL's advanced multimodal reasoning brings unparalleled precision to the table.

September 30, 2025 - 🎉 Exciting update! We've just released our latest AI model on the TuriX API platform, bringing enhanced performance, smarter reasoning, and seamless integration for even more powerful desktop automation. Developers and researchers, this is your cue—head over to the platform to access it now and elevate your workflows!

Ready to level up? Update your config.json and start automating—happy hacking! 🎉

Stay tuned to our Discord for tips, user stories, and the next big drop.

🖼️ Demos

<h3 align="center">MacOS Demo</h3> Book a flight, hotel and uber. <img src="./doc/booking_demo.gif" width="1600" alt="TuriX macOS demo - booking"> Search iPhone price, create Pages document, and send to contact <img src="./doc/demo1.gif" width="1600" alt="TuriX macOS demo - iPhone price search and document sharing"> 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. <img src="./doc/complex_demo_mac.gif" width="1600" alt="TuriX macOS demo - excel graph to powerpoint"> <h3 align="center">Windows Demo</h3> Search video content in youtube and like it <img src="./doc/win_demo1.gif" width="1600" alt="TuriX Windows demo - video search and sharing"> <h3 align="center">MCP with Claude Demo</h3> Claude search for AI news, and call TuriX with MCP, write down the research result to a pages document and send it to contact <img src="./doc/mcp_demo1.gif" width="1600" alt="TuriX MCP demo - news search and sharing">

✨ Key Features

| Capability | What it means | |------------|---------------| | SOTA default model | Outperforms previous open‑source agents (e.g. UI‑TARS) on success rate and speed on Mac | | No app‑specific APIs | If a human can click it, TuriX can too—WhatsApp, Excel, Outlook, in‑house tools… | | Hot‑swappable "brains" | Replace the VLM policy without touching code (config.json) | | MCP‑ready | Hook up Claude for Desktop or any agent via the Model Context Protocol (MCP) | | Skills (markdown playbooks) | Planner selects relevant skill guides (name + description), brain uses full instructions to plan each step |

📊 Model Performance

Our agent achieves state-of-the-art performance on desktop automation tasks:

For more details, check our report.

🚀 Quick‑Start (macOS 15+)

We never collect data—install, grant permissions, and hack away.

0. Windows Users: Switch to the multi-agent-windows branch for Windows-specific setup and installation instructions.
git checkout multi-agent-windows
For the updated OpenClaw Windows local skill package, see OpenCLaw_TuriX_skill/README.md in that branch.

0. Linux Users: Switch to the multi-agent-linux branch for Linux-specific setup and installation instructions.
git checkout multi-agent-linux
0. Windows Legacy Users: For the previous Windows setup, switch to the windows_legacy branch.

0. macOS Legacy Users: For the previous single-model macOS setup, switch to the mac_legacy branch.

1. Download the App

For easier usage, download the app

Or follow the manual setup below:

2. Create a Python 3.12 Environment

Firstly Clone the repository and run:

conda create -n turix_env python=3.12
conda activate turix_env        # requires conda ≥ 22.9
pip install -r requirements.txt

3. Grant macOS Permissions

3.1 Accessibility

Open System Settings ▸ Privacy & Security ▸ Accessibility
Click ＋, then add Terminal and Visual Studio Code ANY IDE you use
If the agent still fails, also add /usr/bin/python3

3.2 Safari Automation

Safari ▸ Settings ▸ Advanced → enable Show features for web developers
In the new Develop menu, enable
- Allow Remote Automation
- Allow JavaScript from Apple Events

TuriX CUA

Install / Use

README