sammcj/gollama

Gollama – 用於管理 Ollama 模型的終端 UI

它是什麼 – Gollama 是一個小型 Go 程式（macOS / Linux），可與本地 Ollama API 通訊，讓您檢視、執行、編輯、複製、刪除、推送並以其他方式操作已安裝的模型。它在文字型使用者介面（TUI）中執行，可完全透過熱鍵導航，並提供少量命令列旗標以實現快速、可腳本化的操作。

為何重要 – Ollama 是本地部署 LLM 的流行方式，但其命令列工具僅限於基本的 ollama pull/run 等操作。Gollama 增加了更豐富、互動性更高的層：您可以依大小、量化等級、模型家族或修改日期排序與篩選模型；檢視詳細的元資料；在您喜愛的編輯器中直接編輯模型的 Modelfile；估算特定量化等級與上下文長度所需的 VRAM；並將模型推送到註冊表——所有操作均無需離開終端。

主要功能（如文件所述）

以名稱、大小、量化等級、家族、修改日期等欄位列出模型
可在任意欄位上排序與篩選
熱鍵操作：Space（選擇）、Enter（執行）、i（檢視）、D（刪除）、e（編輯）、c（複製/重新命名）、U（卸載全部）、p/ctrl+p（拉取）、P（推送）、t（顯示正在執行的模型）等
從 UI 直接編輯模型的 Modelfile（使用設定中指定的編輯器或 $EDITOR）
VRAM 評估器可列印出多種量化等級與上下文長度的記憶體使用表格，並可為給定記憶體預算建議最佳量化等級
簡單的 CLI 快捷方式（gollama -l 列出模型，-e <model> 編輯模型，-s <term> 搜尋，--vram … 進行記憶體分析）
JSON 設定檔（~/.config/gollama/config.json）用於設定預設排序、可見欄位、API 端點、日誌等級、主題、編輯器，以及執行模型的可選 Docker 容器
主題支援（dark-neon、light-neon 或自訂 JSON 主題）
日誌記錄至 ~/.config/gollama/gollama.log，可設定日誌等級

安裝 – README 推薦使用 Go 工具鏈：

go install github.com/sammcj/gollama/v2@latest

或者您可以使用 curl 下載安裝腳本，或從發行頁面下載預先建構的二進位檔並放置到 $PATH 中。

典型用法 – 安裝後，只需執行 gollama（或別名為 g）。TUI 開啟，顯示您的模型。使用上述鍵綁定來管理它們。對於快速的一行指令，可以使用旗標，例如：

gollama -l                     # 不使用 UI 列出模型

gollama -e my-model               # 編輯模型的 Modelfile

gollama --vram llama3.1:8b-instruct-q6_K   # 顯示 VRAM 評估表

設定 – 提供範例 config.json；重要欄位：

default_sort / sort_order – 列表的初始排序方式
columns – 要顯示的欄位
ollama_api_url – 通常為 http://localhost:11434
editor – 外部編輯器路徑（VS Code 可用）
theme – 主題 JSON 檔案名
docker_container – 在 Docker 容器中執行 Ollama 的實驗性支援

狀態 – 此專案仍在積極開發中（根據 README，v2.0.1 於 2025 年 12 月發布）。作者指出，LM Studio 集成已被移除，且因專注於其他專案，開發速度已放緩。

授權 – 倉儲包含標準開源授權（摘錄中未顯示確切的 SPDX 標識符，但列在 License 部分）。

以上所有細節均直接取自倉儲的 README；未推斷任何額外功能。

sammcj/gollama

Gollama – 用於管理 Ollama 模型的終端 UI

相關