Chat UI documentation

Problemas comunes

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Problemas comunes

403: No tienes acceso a esta conversación

Esto suele ocurrir al ejecutar Chat UI sobre HTTP sin una configuración adecuada de cookies.

Recomendado: Configura un proxy inverso (NGINX, Caddy) para manejar HTTPS.

Alternativa: Si debes ejecutarlo sobre HTTP, establece la siguiente variable de entorno:

COOKIE_SECURE=false

Esto establece automáticamente COOKIE_SAMESITE en lax, que es el valor correcto para las implementaciones HTTP.

Asegúrate también de que PUBLIC_ORIGIN coincida con tu URL real:

PUBLIC_ORIGIN=http://localhost:5173

Los modelos no se cargan

Si los modelos no aparecen en la interfaz de usuario:

  1. Verifica que OPENAI_BASE_URL sea correcta y accesible
  2. Comprueba que OPENAI_API_KEY es válida
  3. Asegúrate de que el punto final devuelva los modelos en ${OPENAI_BASE_URL}/models

Errores de conexión a la base de datos

Para el desarrollo, puedes omitir MongoDB por completo: la interfaz de chat utilizará una base de datos integrada.

Para producción, verifica:

  • MONGODB_URL es una cadena de conexión válida
  • Tu IP está en la lista blanca (para MongoDB Atlas)
  • El usuario de la base de datos tiene permisos de lectura/escritura
Update on GitHub