Llama MacOS Desktop Controller

Llama MacOS Desktop Controller 是一套跑在自己電腦上的桌面應用程式，讓你用自然語言操作 macOS。你輸入或說出「開啟某個 App」「把視窗排好」這類指令，工具就請本機的 Llama 模型寫出對應的 Python 程式碼來完成動作。前端以 React 打造，負責接收輸入；後端是 Flask，負責與 LlamaStack 溝通，由它產生程式碼。

這個專案在 GitHub 上發表，原本是 LlamaStack 的示範作品。LlamaStack 是 Meta 用來執行 Llama 模型的開放堆疊。它鎖定開發者與愛動手的人，想看小型本機模型能把日常指令轉成多少真正的系統呼叫。由於一切都在本機執行，不必來回雲端，也不用註冊帳號。

問題在於它是示範，不是完成品。它只在 macOS 上跑，開工前得先備妥 Python、Node.js、Ollama 與一個執行中的 LlamaStack 容器，而且安全檢查很單薄，一行寫壞的程式碼就可能動到整個系統。

Getting Started

1. 安裝前置工具：Node.js 16 以上與 npm、Python 3.8 以上與 pip、Ollama，並下載 Llama 3.2 3B Instruct 模型。
2. 用 Docker 在 5001 埠啟動 LlamaStack，指向你本機的 Ollama 伺服器。
3. 進入後端資料夾，安裝 Python 相依套件並執行 server.py，讓 Flask API 在 5066 埠監聽。
4. 在專案根目錄執行 npm install 與 npm run dev，把 React 前端開在 5173 埠。
5. 用瀏覽器打開 localhost:5173，確認狀態指示燈變綠，接著輸入或口述指令，看產生的程式碼實際跑起來。