跳至主要内容

LLiMa 指令列介面

在 Modalix 上使用 llima CLI 來管理預先編譯的模型,並進行簡單的執行階段測試。這對於檢查模型是否能正確載入、接受提示,以及在您將其與 Neat Framework 的直接 API 或 Neat GenAI 伺服器端點整合之前,是否能產生輸出結果,都非常有用。

模型管理員

LLiMa 包含一個模型管理工具,透過 llima CLI 進行操作。您可以透過它來搜尋、下載、列出、移除,以及直接從命令列執行預先編譯的模型。模型預設儲存在 /media/nvme/llima/models 目錄下。設定 LLIMA_MODELS_PATH 以使用不同的模型目錄。

瀏覽可用的模型:

modalix:~$ llima search
modalix:~$ llima search qwen

透過名稱下載模型,但不要包含 simaai/ 組織的字首:

modalix:~$ llima pull Qwen3-VL-4B-Instruct-GPTQ-a16w4

模型成品會同時下載,其中最大的成品會優先排程。暫時性的 HTTP 錯誤會自動重試。對於同一個模型,下載請求會依序處理,且取消下載請求會保留所有已下載並驗證過的成品。

列出並移除本機安裝的模型:

modalix:~$ llima list
modalix:~$ llima rm Qwen3-VL-4B-Instruct-GPTQ-a16w4

執行 LLiMa

使用 llima run 作為一個簡單的執行階段,用於在 Modalix 上進行初始模型驗證。

在 CLI 模式下,聊天記錄預設會啟用。每個提示和回應都會被保留,作為下一次對話的上下文,直到您使用 clear history 清除它。

modalix:~$ llima run <model> [options]
論點;爭論描述
model模型 ID 或路徑(例如:Qwen3-VL-8B-Instruct-a16w4)。
--stt_model_path語音轉文字模型的 ELF 檔案路徑(選用)。

若要查看所有可用的選項,請執行 llima run -h

範例

modalix:~$ llima run Qwen3-VL-4B-Instruct-GPTQ-a16w4

互動式指令

一旦在命令列介面 (CLI) 模式下啟動 llima run,請在提示字元處使用以下指令:

指令描述
add image <file>將圖片新增到目前的提示詞內容中。
clear image清除所有圖片。
set system <prompt>設定系統提示。
clear system清除系統提示、聊天記錄和圖片。
clear history清除聊天記錄和圖片。
print history列印聊天記錄。
set audio <file>將音訊檔案設定為要進行轉錄的查詢內容。
set language <lang>設定用於轉錄的語言字串。
set lora <name>使用來自 npy_files 資料夾的 LoRA 權重。
unset lora將 LoRA 模型還原至基準模型。
enable-thinking啟用思考模式,並清除聊天記錄。
disable-thinking關閉思考模式並清除聊天記錄。
quit退出。
help列印可用的指令。

使用 Neat 建立應用程式

在用 llima run 驗證您的模型後,請參閱 GenAI 模型 ,以便透過通用的 API 端點來部署它,或直接從 C++ 或 Python 應用程式中使用它。