GGUF SAFETENSORS
Conversão de arquivo

Converter GGUF para SAFETENSORS

RESPOSTA RÁPIDA
É possível converter GGUF para SAFETENSORS?
Sim - GGUF converte para SAFETENSORS.

Execute um conversor como gguf_to_safetensors ou GGUF2Safetensors; ele lê o GGUF com a biblioteca gguf, faz o upcast de cada tensor para F16 (ou BF16) e grava arquivos .safetensors. Espere que a saída seja uma aproximação dos pesos originais sempre que o GGUF tiver sido quantizado abaixo de F16.

Também para SAFETENSORS: PICKLE

Nesta página

Testado em macOS, Windows e Linux
Última verificação em Nov 2026

Mais conversores gratuitos

HEIC, PNG, WEBP, MP3 e mais - todas as ferramentas aqui são gratuitas.

Abrir a caixa de ferramentas

Por que converter GGUF para SAFETENSORS?

Converter .gguf para .safetensors permite carregar um modelo de volta no Hugging Face Transformers ou diffusers, ajustá-lo (fine-tune) ou re-quantizá-lo de forma diferente. GGUF é otimizado para inferência no llama.cpp, enquanto .safetensors é o formato padrão e livre de pickle para o ecossistema PyTorch/HF. Note que revisões muito recentes do formato GGUF nem sempre são conversíveis.

Como converter GGUF para SAFETENSORS

gguf_to_safetensors OPEN-SOURCE

Execute python gguf_to_safetensors.py --input model.gguf --output model.safetensors. O padrão é F16; adicione --bf16 para saída em BF16.

GGUF2Safetensors OPEN-SOURCE

Faz o upcast dos pesos GGUF para tensores PyTorch na memória e grava uma pasta Hugging Face de fragmentos .safetensors, utilizável diretamente com Transformers.

biblioteca gguf + safetensors FREE

Carregue com GGUFReader, chame gguf.quants.dequantize() por tensor e depois safetensors.torch.save_file(). Controle total sobre dtype e fragmentação (sharding).

Sobre estes formatos

Qualidade e o que observar

  • Dequantizar um GGUF quantizado (Q4/Q5/etc.) é um processo com perdas (lossy) - o .safetensors não corresponderá ao modelo original bit a bit.
  • Versões mais recentes do formato GGUF podem falhar na conversão porque o ferramental costuma estar atrasado em relação às mudanças do llama.cpp.
  • A saída é F16/BF16 (ou F32), portanto o tamanho do arquivo cresce significativamente em comparação ao GGUF quantizado compacto.

Perguntas frequentes

A conversão GGUF para safetensors é lossless?
Apenas se o GGUF foi armazenado em F16/F32. Qualquer quantização inferior é dequantizada de forma aproximada e não pode ser revertida exatamente.
Por que meu GGUF recente falhou ao converter?
O GGUF evolui rapidamente; alguns conversores estão presos a revisões antigas e não conseguem analisar novos arquivos ou tipos de quantização.
Posso carregar o resultado no Hugging Face Transformers?
Sim, se você gerar uma pasta HF adequada (configuração mais .safetensors fragmentados), que é o objetivo do GGUF2Safetensors.
Saída F16 ou BF16?
BF16 preserva melhor a faixa dinâmica para modelos grandes; F16 é suportado de forma mais universal. Escolha de acordo com sua configuração de treinamento.