Skip to main content
LibreChat is joining ClickHouse to power the open-source Agentic Data Stack 🎉 Learn more
LibreChat

HuggingFace

Despliegue fácilmente LibreChat en Hugging Face Spaces

Crear y configurar su base de datos (Requerido)

Lo primero que necesitas es crear una base de datos en MongoDB Atlas y obtener tu cadena de conexión.

Siga las instrucciones en este documento: MongoDB Atlas

Primeros pasos

1. Inicia sesión o crea una cuenta en Hugging Face

2. Visita https://huggingface.co/spaces/LibreChat/template y haz clic en Duplicate this Space para copiar la plantilla de LibreChat en tu perfil.

Nota: Es normal que esta plantilla presente un error de tiempo de ejecución; deberá configurarla siguiendo la siguiente guía para que sea funcional.

image

3. Nombre su Space y rellene los Secrets y Variables

También puedes decidir aquí si hacerlo público o privado

image

Deberá completar estos valores:

SecretosValores
MONGO_URI* utilice estas instrucciones para obtener la cadena: https://librechat.ai/docs/configuration/mongodb/mongodb_atlas
OPENAI_API_KEYuser_provided
BINGAI_TOKENuser_provided
CHATGPT_TOKENuser_provided
ANTHROPIC_API_KEYuser_provided
GOOGLE_KEYuser_provided
CREDS_KEY* ver más abajo
CREDS_IV* ver más abajo
JWT_SECRET* ver más abajo
JWT_REFRESH_SECRET* ver más abajo

⬆️ Deje el campo de valor en blanco para cualquier endpoint que desee deshabilitar.

⚠️ configurar las API keys y el token como user_provided le permite proporcionarlos de forma segura desde la webUI

  • Para CREDS_KEY, CREDS_IV y JWT_SECRET utiliza esta herramienta: Generador de credenciales
  • Ejecute la herramienta una segunda vez y utilice el nuevo valor de JWT_SECRET para el JWT_REFRESH_SECRET
VariablesValues
APP_TITLELibreChat
ALLOW_REGISTRATIONtrue

Despliegue

1. Cuando hayas terminado de completar los secrets y variables, haz clic en Duplicate Space en la parte inferior de esa ventana

image

2. El proyecto comenzará a compilarse, esto tomará un par de minutos

image

3. Cuando esté listo, Building cambiará a Running

image

¡Y podrás acceder a LibreChat!

image

Actualización

Para actualizar LibreChat, simplemente seleccione Factory Reboot en el menú de ⚙️Settings.

image

Conclusión

Ahora puedes acceder a él desde la URL actual. Si deseas acceder sin la superposición de Hugging Face, puedes modificar esta plantilla de URL con tu información:

https://username-projectname.hf.space/

p. ej. https://cooluser-librechat.hf.space/

🎉 ¡Felicidades, has desplegado LibreChat con éxito en Hugging Face! 🤗

Configuración de Meilisearch (Opcional)

Para habilitar la funcionalidad de búsqueda en LibreChat, necesitarás desplegar y configurar una instancia de Meilisearch. Aquí te explicamos cómo hacerlo:

1. Duplicar el espacio de Meilisearch:

Visita este enlace: https://huggingface.co/spaces/LibreChat/meilisearch y haz clic en "Duplicate this Space".

2. Configurar el espacio de Meilisearch:

  • Visibilidad: Establezca la visibilidad en "public".

  • MEILI_MASTER_KEY: Genere una clave maestra segura de 16 caracteres. Puede utilizar una herramienta como https://randomkeygen.com/ para generar una clave aleatoria. Establezca esta clave como el valor para la variable de entorno MEILI_MASTER_KEY en el espacio de Meilisearch. Importante: ¡Mantenga esta clave segura!

  • MEILI_ENV: Establezca la variable de entorno MEILI_ENV en production.

3. Duplicar el Space:

Haz clic en el botón "Duplicate Space".

4. Configurar LibreChat para usar Meilisearch:

  • Edita el Dockerfile: Ve a tu espacio de LibreChat (el que duplicaste desde la plantilla principal de LibreChat). Navega a "Files" -> "Dockerfile" y haz clic en "Edit".

  • Descomentar y modificar líneas: Descomente/edite las siguientes líneas en el Dockerfile. Estas líneas contendrán ENV SEARCH y ENV MEILI_*. Asegúrese de reemplazar <YOUR_MEILISEARCH_SPACE_URL> con la URL real de su despliegue de Meilisearch en Hugging Face Spaces. Debería verse algo como https://username-meilisearch.hf.space/. ¡Actualice el nombre de usuario para que coincida con el suyo!

    ENV SEARCH=true
    ENV MEILI_NO_ANALYTICS=true
    ENV MEILI_HOST=<YOUR_MEILISEARCH_SPACE_URL>
  • Confirmar cambios: Confirme sus cambios en la rama main.

5. Añadir el secreto MEILI_MASTER_KEY a LibreChat:

  • Ve a la configuración de tu espacio de LibreChat (la implementación de LibreChat, no la de Meilisearch).

  • Haz clic en "New secret".

  • Nombre: Introduzca MEILI_MASTER_KEY.

  • Valor: Introduzca la misma clave maestra que utilizó al configurar el espacio de Meilisearch.

6. Verificar la configuración:

Después de que LibreChat se reconstruya y comience a ejecutarse, deberías ver una opción de búsqueda en la parte superior izquierda de la interfaz de LibreChat. Si no la ves, verifica dos veces que hayas seguido todos los pasos correctamente.

¿Qué te parece esta guía?