id = "gollama"
name = "Gollama"
homepage = "https://github.com/sammcj/gollama"
description = "A terminal UI for managing Ollama models."
executables = ["gollama"]

[dotfiles]

# Upstream README documents config.json, themes/, and the log path.
# https://github.com/sammcj/gollama#configuration
paths = ["~/.config/gollama/config.json", "~/.config/gollama/themes/"]
exclude = [
  "~/.config/gollama/gollama.log",
]
secret = []

[[dotfiles.secret_paths]]
file = "~/.config/gollama/config.json"
format = "json"
match = { key_path = ["ollama_api_key"] }

[commands]
format = 1
label = "List, search or estimate models"
description = "Non-interactive Gollama jobs: list or search Ollama models, edit a Modelfile, or estimate vRAM. The interactive TUI (no flags) and model-linking options are not covered."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "readme"
kind = "help"
url = "https://raw.githubusercontent.com/sammcj/gollama/HEAD/README.md"
revision = "2026-10-27"
evidence = """
gollama -l
gollama -e my-model
gollama -s my-model # returns models that contain 'my-model'
gollama -s 'my-model|my-other-model' # returns models that contain either 'my-model' or 'my-other-model'
gollama --vram llama3.1:8b-instruct-q6_K
gollama --vram NousResearch/Hermes-2-Theta-Llama-3-8B --fits 6
  - `--fits`: Available memory in GB for context calculation (e.g. `6` for 6GB)
  - `--vram-to-nth` or `--context`: Maximum context length to analyze (e.g. `32k` or `128k`)
  - `--quant`: Override quantisation level (e.g. `Q4_0`, `Q5_K_M`)
gollama --create-from-lmstudio --log-level debug
Available log levels: `debug`, `info`, `warn`, `error`
"""

[[commands.field]]
id = "list"
label = "List models"
description = "Print the model list without starting the TUI."
type = "boolean"
option = ["-l"]
sources = ["readme"]

[[commands.field]]
id = "search"
label = "Search models"
description = "Substring; use | for either term and & for both."
type = "string"
option = ["-s"]
sources = ["readme"]

[[commands.field]]
id = "edit"
label = "Edit Modelfile of"
type = "string"
option = ["-e"]
sources = ["readme"]

[[commands.field]]
id = "vram"
label = "Estimate vRAM for model"
description = "An Ollama model (name:tag) or a HuggingFace ID (author/name)."
type = "string"
option = ["--vram"]
sources = ["readme"]

[[commands.field]]
id = "fits"
label = "Memory available (GB)"
description = "Find the best quantisation that fits this much memory."
type = "number"
option = ["--fits"]
sources = ["readme"]

[[commands.field]]
id = "quant"
label = "Quantisation override"
type = "string"
option = ["--quant"]
suggestions = [{ value = "Q4_0", label = "Q4_0" }, { value = "Q5_K_M", label = "Q5_K_M" }]
sources = ["readme"]

[[commands.field]]
id = "log_level"
label = "Log level"
type = "enum"
option = ["--log-level"]
choices = [{ value = "debug", label = "Debug" }, { value = "info", label = "Info" }, { value = "warn", label = "Warn" }, { value = "error", label = "Error" }]
sources = ["readme"]

[[commands.task]]
id = "list"
label = "List models"
fields = ["list"]
required = ["list"]
set = { list = [true] }

[[commands.task]]
id = "search"
label = "Search models"
fields = ["search"]
required = ["search"]

[[commands.task]]
id = "vram"
label = "Estimate vRAM"
fields = ["vram", "fits", "quant"]
required = ["vram"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["list", "search", "edit", "vram", "fits"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["quant", "log_level"]