gollama

命令行一键管理 Ollama 模型,告别繁琐操作

gollama 是一个用 Go 语言编写的 Ollama 模型管理工具,旨在通过命令行简化 Ollama 本地模型的下载、复制、删除和更新等操作。它解决了 Ollama 原生 CLI 在多模型管理场景下操作繁琐、缺乏批量处理能力的问题,提供了交互式选择界面和通配符匹配,让用户可以快速筛选和操作模型。核心能力包括列出本地模型、拉取远程模型、复制模型、删除模型、更新模型,以及支持自定义 Ollama 服务地址和模型存储路径。通过简单的命令和交互式提示,gollama 提升了模型管理的效率和体验,适合需要频繁管理多个模型的开发者和 AI 爱好者。

开源 free 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1836
维护状态 维护中
是否开源
定价模式 free

项目数据

分类开源模型
开发团队sammcj
所属国家
定价模式free
价格说明开源项目,MIT许可证,完全免费,无付费版本。
访问状态
是否开源
开源协议MIT
主要语言Go
技术栈/模型ai,ggml,gguf,linux,llm,macos,models,ollama,tui
GitHub 星标★ 1836
30天Star增速
HF 下载量
上线时间2024-05-30 00:00:00
最近更新2026-09-23 00:00:00
维护状态维护中
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数3

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 7 步

环境要求

  • macOS 或 Linux 系统(README 明确该工具面向这两个平台)
  • 已安装 Go 环境(使用 go install 或源码编译时需要)
  • 本地运行 Ollama 服务,默认地址 http://localhost:11434
  • 访问远程或私有仓库模型时需准备对应 API Key

安装与启动步骤

  1. 1安装 gollama

    README 推荐用 go install 直接安装最新版本,会把可执行文件放到 Go 的 bin 目录。

    go install github.com/sammcj/gollama/v2@latest
  2. 2配置命令别名

    可选操作,把 gollama 简写成 g,方便日常快速调用,写入 shell 配置后需重开终端。

    echo "alias g=gollama" >> ~/.zshrc
  3. 3启动 TUI 界面

    直接运行命令即可进入交互式界面,用热键对模型进行选择、排序、过滤和操作。

    gollama
  4. 4编辑配置文件

    配置文件位于 ~/.config/gollama/config.json,按 README 示例填写排序、列、API 地址、日志、编辑器等选项。

  5. 5克隆源码仓库

    如果不想用 go install,可以从源码构建;克隆后进入项目目录。

    git clone https://github.com/sammcj/gollama.git
    cd gollama
  6. 6编译源码

    先获取依赖,再用 Makefile 编译,README 未说明 Makefile 具体目标细节。

    go get
    make build
  7. 7运行本地构建

    编译完成后在当前目录运行生成的可执行文件,效果与 go install 安装的版本一致。

    ./gollama

关键配置

配置项必填说明示例
ollama_api_urlOllama 服务地址,指向本地或远程实例http://localhost:11434
ollama_api_key访问 Ollama API 所用密钥,本地一般留空
default_sortTUI 列表的默认排序字段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

项目介绍

gollama 是基础设施领域的开源项目,由 sammcj 开发,2024 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(1,836)位列前 30%,在基础设施分类中处于中上游。

项目仍在小幅维护中,最近一次代码更新于 2026-09-23。MIT许可证,完全免费,无付费版本。

它主要面向的使用场景是:本地开发时快速切换和清理多个Ollama模型。同类可对比的替代方案包括 ollama CLI(官方)、Open WebUI、Lobe Chat。

上一篇:tokenspeed

下一篇:beta9

同类项目推荐

freebuff-proxy 开源

聚合多账号,一键接入 OpenAI 兼容 API,轻松管理会话。

Multi-account OpenAI-compatible gateway for coding models. Pooled keys, session life···

★ 213 2026-08-20
microduck 开源

用 Rust 造一只会走路的桌面小鸭,快速上手双足机器人。

A Tiny biped duck robot

★ 8684 2026-09-10
soperator 开源

用 Kubernetes 原生方式运行 Slurm,简化 HPC 集群管理。

Run Slurm in Kubernetes

★ 439 2026-08-10
ollama 开源

一条命令本地跑起大模型,免费、私密、不卡顿

Get up and running with Kimi, GLM, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other···

★ 181484 2026-08-09