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

相关