ramalama-list(1)

✨ ramalama-list ✨

okay bestie, welcome to ramalama-list 💖 — it's the list command from the ramalama family, and it lives in the General Commands Manual section, so you already know it's giving main-character Unix energy 👑

---

🌸 NAME 🌸

ramalama-list — list all downloaded AI Models 🦋

---

🎀 SYNOPSIS 🎀

ramalama list [options]

ramalama ls [options]

yes bestie, ls is literally right there too, the alias ate 💅

---

🧚 DESCRIPTION 🧚

So what this does is: it lists all the AI Models chillin' in your local storage 📦✨

Quick vibe check though — if you wanna see the models that are currently loaded by a running inference server (like, say, after ramalama serve), that's a whole different page. Go read ramalama-models(1) instead, no cap 🫶

Now here's the cute part 🌈: when a downloaded model URI matches an entry in shortnames.conf, the table grows a SHORTNAME column with the matching alias — like gemma3:12b standing in for hf://ggml-org/gemma-3-12b-it-GGUF 🎉 Models that don't have a configured alias just leave SHORTNAME empty, and that's fine, we don't judge 🙈 And if you wanna peek at the configured shortname mappings themselves, ramalama-info(1) has you 💜

---

✨ OPTIONS ✨

• --all — include partially downloaded Models 👀 (yes, the half-finished ones get to be seen too)
• --help, -h — show this help message and exit 🆘
• --json — print Model list in json format 🧾
• --noheading, -n — do not print heading 🙈
• --order — order used to sort the AI Models. Valid options are 'asc' and 'desc' 🔀
• --sort — field used to sort the AI Models. Valid options are 'name', 'size', and 'modified' 📊

---

🔥 EXAMPLES 🔥

List all Models downloaded to the local store

$ ramalama list
SHORTNAME   NAME                                                                MODIFIED     SIZE
smollm:135m ollama://smollm:135m                                                16 hours ago 5.5M
            huggingface://afrideva/Tiny-Vicuna-1B-GGUF/tiny-vicuna-1b.q2_k.gguf 14 hours ago 460M
            ollama://granite-code:3b (partial)                                  5 days ago   1.9G
            ollama://granite-code:latest                                        1 day ago    1.9G
            ollama://moondream:latest                                           6 days ago   791M

see that (partial) hanging out in there? iconic honestly 💀

List all Models in JSON format (each object includes shortname, name, modified, and size)

$ ramalama list --json
[
  {
    "shortname": "gemma3:12b",
    "name": "hf://ggml-org/gemma-3-12b-it-GGUF",
    "modified": "2026-05-21T12:00:00+00:00",
    "size": 8150000000
  },
  {
    "shortname": "",
    "name": "ollama://moondream:latest",
    "modified": "2026-05-15T08:00:00+00:00",
    "size": 829000000
  }
]

---

👑 SEE ALSO 👑

ramalama(1), ramalama-models(1)

---

💜 HISTORY 💜

Aug 2024, Originally compiled by Dan Walsh dwalsh@redhat.com ⟨mailto:dwalsh@redhat.com⟩ — ty Dan, we stan 🫡🌸

---

okay that's the whole page bestie, go forth and ramalama list 💅✨ This was the ramalama-list(1) page, part of the General Commands Manual — mwah, ily, bye 🎀🦋💖