oobabooga/textgen · error · Exception

You are using an outdated GGUF, please download a new one.

Error message

You are using an outdated GGUF, please download a new one.

What it means

Error "You are using an outdated GGUF, please download a new one." thrown in oobabooga/textgen.

Source

Thrown at modules/metadata_gguf.py:75

            pass
    else:
        type_str = _simple_value_packing.get(value_type)
        bytes_length = value_type_info.get(value_type)
        value = struct.unpack(type_str, file.read(bytes_length))[0]

    return value


def load_metadata(fname):
    metadata = {}
    with open(fname, 'rb') as file:
        GGUF_MAGIC = struct.unpack("<I", file.read(4))[0]
        GGUF_VERSION = struct.unpack("<I", file.read(4))[0]
        ti_data_count = struct.unpack("<Q", file.read(8))[0]
        kv_data_count = struct.unpack("<Q", file.read(8))[0]

        if GGUF_VERSION == 1:
            raise Exception('You are using an outdated GGUF, please download a new one.')

        for i in range(kv_data_count):
            key_length = struct.unpack("<Q", file.read(8))[0]
            key = file.read(key_length)

            value_type = GGUFValueType(struct.unpack("<I", file.read(4))[0])
            if value_type == GGUFValueType.ARRAY:
                ltype = GGUFValueType(struct.unpack("<I", file.read(4))[0])
                length = struct.unpack("<Q", file.read(8))[0]

                arr = [get_single(ltype, file) for _ in range(length)]
                metadata[key.decode()] = arr
            else:
                value = get_single(value_type, file)
                metadata[key.decode()] = value

    return metadata

View on GitHub (pinned to ed888c71f2)

Solutions

  1. Download a newer copy of the model; the GGUF file uses an outdated format version.
  2. Re-quantize or convert the model to a current GGUF version.

When it happens

Trigger: Raised when reading GGUF metadata from a model file whose GGUF format version is older than the supported minimum. Triggers when loading very old GGUF files; download a newer conversion of the model.

Common situations: See trigger scenarios.


AI-assisted analysis of oobabooga/textgen@ed888c71f2 (2026-08-15). Data as JSON: /api/errors/02431a27444e08aa. Report an issue: GitHub.