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.
3. Nombre su Space y rellene los Secrets y Variables
También puedes decidir aquí si hacerlo público o privado
Deberá completar estos valores:
| Secretos | Valores |
|---|---|
| MONGO_URI | * utilice estas instrucciones para obtener la cadena: https://librechat.ai/docs/configuration/mongodb/mongodb_atlas |
| OPENAI_API_KEY | user_provided |
| BINGAI_TOKEN | user_provided |
| CHATGPT_TOKEN | user_provided |
| ANTHROPIC_API_KEY | user_provided |
| GOOGLE_KEY | user_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_providedle permite proporcionarlos de forma segura desde la webUI
- Para
CREDS_KEY,CREDS_IVyJWT_SECRETutiliza esta herramienta: Generador de credenciales- Ejecute la herramienta una segunda vez y utilice el nuevo valor de
JWT_SECRETpara elJWT_REFRESH_SECRET
| Variables | Values |
|---|---|
| APP_TITLE | LibreChat |
| ALLOW_REGISTRATION | true |
Despliegue
1. Cuando hayas terminado de completar los secrets y variables, haz clic en Duplicate Space en la parte inferior de esa ventana
2. El proyecto comenzará a compilarse, esto tomará un par de minutos
3. Cuando esté listo, Building cambiará a Running
¡Y podrás acceder a LibreChat!
Actualización
Para actualizar LibreChat, simplemente seleccione Factory Reboot en el menú de ⚙️Settings.
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_KEYen el espacio de Meilisearch. Importante: ¡Mantenga esta clave segura! -
MEILI_ENV: Establezca la variable de entorno
MEILI_ENVenproduction.
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 SEARCHyENV 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! -
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?