项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1843
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- macOS 或 Linux 系统(README 明确该工具面向这两个平台)
- 已安装 Go 环境(使用 go install 或源码编译时需要)
- 本地运行 Ollama 服务,默认地址 http://localhost:11434
- 访问远程或私有仓库模型时需准备对应 API Key
安装与启动步骤
-
1安装 gollama
README 推荐用 go install 直接安装最新版本,会把可执行文件放到 Go 的 bin 目录。
go install github.com/sammcj/gollama/v2@latest -
2配置命令别名
可选操作,把 gollama 简写成 g,方便日常快速调用,写入 shell 配置后需重开终端。
echo "alias g=gollama" >> ~/.zshrc -
3启动 TUI 界面
直接运行命令即可进入交互式界面,用热键对模型进行选择、排序、过滤和操作。
gollama -
4编辑配置文件
配置文件位于 ~/.config/gollama/config.json,按 README 示例填写排序、列、API 地址、日志、编辑器等选项。
-
5克隆源码仓库
如果不想用 go install,可以从源码构建;克隆后进入项目目录。
git clone https://github.com/sammcj/gollama.git cd gollama -
6编译源码
先获取依赖,再用 Makefile 编译,README 未说明 Makefile 具体目标细节。
go get make build -
7运行本地构建
编译完成后在当前目录运行生成的可执行文件,效果与 go install 安装的版本一致。
./gollama
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
ollama_api_url | 否 | Ollama 服务地址,指向本地或远程实例 | http://localhost:11434 |
ollama_api_key | 否 | 访问 Ollama API 所用密钥,本地一般留空 | |
default_sort | 否 | TUI 列表的默认排序字段 | modified |
columns | 否 | 列表中显示的列,可按需增减 | ["Name", "Size", "Quant", "Family", "Modified", "ID"] |
editor | 否 | 编辑 Modelfile 使用的编辑器,留空则回退 EDITOR 环境变量再默认 vim | /Applications/Visual Studio Code.app/Contents/Resources/app/ |
docker_container | 否 | 实验性;设置后 run 操作会在指定容器内执行 | |
如何确认成功
运行 gollama 后能进入 TUI 界面并列出本地 Ollama 模型,即表示安装和使用正常。
常见问题
Q:提示 command not found: gollama 怎么办?
A:说明可执行文件不在 PATH 中。README 专门设有该问题的章节,通常需要把 Go 的 bin 目录(GOPATH/bin 或 GOBIN)加入环境变量 PATH。
Q:怎么修改编辑 Modelfile 用的编辑器?
A:在 config.json 的 editor 字段填写编辑器路径;该字段为空时会依次回退到 EDITOR 环境变量,最后默认使用 vim。
Q:模型名带私有仓库前缀,显示太长怎么办?
A:配置 strip_string,例如填 my-private-registry.internal/,TUI 中显示模型名时会自动去掉该前缀。
Q:这个工具支持 Windows 吗?
A:README 说明 Gollama 是 macOS / Linux 下管理 Ollama 模型的工具,未提及 Windows 支持。
Q:怎么让运行操作在 Docker 容器里执行?
A:设置 docker_container 为容器名即可,但 README 标注该功能为实验性,可能不稳定。
注意事项
- README 更新说明提到项目维护节奏已放缓,且移除了 LM Studio 关联功能。
- theme 与 docker_container 均为实验性配置项,慎用于生产环境。
- curl 安装与手动安装两节在 README 中仅有标题、无具体内容,请以 go install 或源码构建方式为准。
- 源码构建依赖 Makefile,README 未说明 make 的具体目标与构建前提。
核心亮点
- 交互式选择界面,无需记忆模型名称即可操作
- 支持通配符批量操作,一次处理多个模型
- 可自定义服务地址和存储路径,灵活适配环境
不足之处
- 依赖 Ollama 环境,不适用于其他模型运行时
- 文档/社区待观察
适用场景
- 本地开发时快速切换和清理多个 Ollama 模型
- 批量更新或删除不再需要的模型以释放磁盘空间
- 在脚本中集成模型管理自动化流程
替代项目
ollama CLI(官方)、Open WebUI、Lobe Chat
上一篇:tokenspeed
下一篇:beta9
同类项目推荐
numbat
开源
给终端上的 AI 智能体装上监控和刹车,看清行为、阻止风险。
Visibility into AI agent activity on endpoints, with on-device detection, optional p···
milvus
开源
海量向量秒级搜索,轻松构建 AI 应用
Milvus is a high-performance, cloud-native vector database built for scalable vector···
SD-to-CoreML
开源
一键转换 Stable Diffusion 模型为 Apple Core ML 格式,轻松部署到 iPhone 和 Mac。
Shell script to convert Stable Diffusion 1.5 models to Core ML
airweave
开源
各种数据源一次接好,智能体随时有料可查
Open-source context retrieval layer for AI agents
llm-d
开源
在 Kubernetes 上榨干 GPU,让 LLM 推理飞起来
State of the art inference performance with modern accelerators on Kubernetes
nndeploy
开源
一套代码搞定多端AI推理,省心又高效
一款简单易用和高性能的AI部署框架 | An Easy-to-Use and High-Performance AI Deployment···
vllm-metal
开源
让 Mac 也能跑 vLLM 高吞吐推理
Community maintained hardware plugin for vLLM on Apple Silicon
new-api
开源
一个网关接入所有大模型,协议随意转换,省心又省钱
Open-source AI gateway. Self-hosted LLM gateway with OpenAI-, Claude- and Gemini-com···
respan-gateway
开源
一个端点接入所有大模型,单二进制即开即用
Open-source LLM gateway in Rust. One endpoint for OpenAI, Anthropic, Gemini and ever···
