Cómo reparar el error de verificación del certificado SSL cuando llama-cli se descarga desde Hugging Face en Windows

Causas comunes y soluciones cuando llama-cli falla la verificación del certificado SSL al descargar modelos de Hugging Face con -hf en Windows.

Si ejecuta este comando en Windows:

1
llama-cli -hf unsloth/gemma-4-E4B-it-GGUF

y veo un error como este:

1
2
get_repo_commit: error: HTTPLIB failed: SSL server verification failed
error: failed to download model from Hugging Face

Por lo general, el problema no es CUDA ni llama.cpp. Más a menudo, el programa no puede acceder correctamente a la cadena de certificados del sistema en el entorno actual, por lo que falla la verificación HTTPS.

Desde el registro, ggml-rpc.dll y ggml-cpu-alderlake.dll se cargaron correctamente, lo que significa que el entorno de ejecución está prácticamente bien. El problema está principalmente en el paso de descarga del modelo.

La solución más sencilla: descargar el modelo manualmente

Si sólo desea que funcione rápidamente, descargar el modelo manualmente suele ser la opción más estable.

  1. Abra la página del repositorio de Hugging Face correspondiente.
  2. Descargue el archivo .gguf requerido desde Archivos y versiones.
  3. Una vez finalizada la descarga, ejecútela con la ruta del archivo local:
1
llama-cli -m C:\Users\knightli\Downloads\gemma-4-e4b-it.gguf

Esto omite la verificación SSL durante el paso de descarga -hf y es útil cuando solo desea verificar que el modelo se puede ejecutar localmente.

Si aún deseas utilizar la descarga automática -hf

Puede especificar manualmente una ruta de archivo de certificado para que el programa pueda encontrar un paquete de CA utilizable en la sesión actual.

cacert.pem se puede obtener de la página de extracto de CA mantenida por el proyecto curl:

Si lo descarga en un navegador, abra el enlace de descarga directa y guárdelo como cacert.pem. También puedes descargarlo a un directorio fijo con PowerShell:

1
2
New-Item -ItemType Directory -Force C:\certs
Invoke-WebRequest -Uri https://curl.se/ca/cacert.pem -OutFile C:\certs\cacert.pem

Una vez finalizada la descarga, configure estas variables en la línea de comando:

1
2
set SSL_CERT_FILE=C:\certs\cacert.pem
set CURL_CA_BUNDLE=C:\certs\cacert.pem

Luego ejecute el comando original nuevamente:

1
llama-cli -hf unsloth/gemma-4-E4B-it-GGUF

Si el problema realmente proviene de la cadena de certificados, esto generalmente lo soluciona directamente.

记录并分享
Creado con Hugo
Tema Stack diseñado por Jimmy