GGUF-NEW-METADATA(1)

✨ NAME ✨

gguf-new-metadata — bestie, it's literally gguf-new-metadata. That's the name. That's the whole vibe. 💅

---

🦋 DESCRIPTION 🦋

okay so the actual usage goes a lil something like this:

usage: gguf-new-metadata [-h] [--general-name "name"]
      [--general-description "Description ..."]
      [--chat-template "{% ... %} ..."]  [--chat-template-config
      tokenizer_config.json] [--chat-template-file chat_template.jinja]
      [--pre-tokenizer "pre tokenizer"] [--remove-metadata general.url]
      [--special-token bos | eos | eot | eom | unknown | seperator |
      padding | mask | fim_pre | fim_suf | fim_mid | fim_pad | fim_rep |
      fim_sep | prefix | suffix | middle "<token>"]
      [--special-token-by-id bos | eos | eot | eom | unknown |
      seperator | padding | mask | fim_pre | fim_suf | fim_mid |
      fim_pad | fim_rep | fim_sep | prefix | suffix | middle 0]
      [--force] [--verbose] input output

And what does it do, you ask? Make a copy of a GGUF file with new metadata. That's it. That's the whole job. Glow-up for your metadata, no cap. 🫶

---

🎀 positional arguments:

• input — the GGUF format model input filename, aka the file you're copying from, the before picture 📸
• output — the GGUF format model output filename, aka where the glow-up lands, the after picture ✨

---

💖 options:

• -h, --help — show this help message and exit. the classic "wait what does this do again" button 🙈
• --general-name "name" — sets the model's general.name 💫
• --general-description "Description ..." — sets the model's general.description, so go off and describe your model, bestie ✍️
• --chat-template "{% ... %} ..." — a chat template string (or a JSON string containing templates) 🗣️
• --chat-template-config tokenizer_config.json — a config file containing chat template(s) 📄
• --chat-template-file chat_template.jinja — a Jinja file containing a chat template 🧚
• --pre-tokenizer "pre tokenizer" — sets the model's tokenizer.ggml.pre 🔤
• --remove-metadata general.url — removes metadata from the output model, and you do it by key name 🗑️
• --special-token bos | eos | eot | eom | unknown | seperator | padding | mask | fim_pre | fim_suf | fim_mid | fim_pad | fim_rep | fim_sep | prefix | suffix | middle "<token>" — special token, specified by value 👑
• --special-token-by-id bos | eos | eot | eom | unknown | seperator | padding | mask | fim_pre | fim_suf | fim_mid | fim_pad | fim_rep | fim_sep | prefix | suffix | middle 0 — special token, but specified by id this time 🔢
• --force — bypass warnings without confirmation. careful with this one, bestie, it's the "yes I'm sure, stop asking me" button and it means exactly that 💀
• --verbose — increase output verbosity, for when you want the program to tell you everything it's feeling 🗯️

ngl the token-type list has seperator spelled like that in the original, and we are not fixing it, because copying things character for character is the whole assignment 💅

---

that's the whole page, babe. copy a GGUF, swap the metadata, hit --force only when you mean it, and go be the main character of your own model repo. 🌈 ⭐

— brought to you by debian, dated September 2026, GGUF-NEW-METADATA(1), User Commands section, mwah 😘 💖