HuggingFace

Crea e configura il tuo database (Obbligatorio)

La prima cosa di cui hai bisogno è creare un database MongoDB Atlas e ottenere la tua stringa di connessione.

Segui le istruzioni in questo documento: MongoDB Atlas

Introduzione

1. Accedi o crea un account su Hugging Face

2. Visita https://huggingface.co/spaces/LibreChat/template e clicca su Duplicate this Space per copiare il template di LibreChat nel tuo profilo.

Nota: È normale che questo template presenti un errore di runtime; dovrai configurarlo seguendo la guida seguente per renderlo funzionale.

3. Dai un nome al tuo Space e compila Secrets e Variables

Puoi anche decidere qui se renderlo pubblico o privato

Dovrai compilare questi valori:

⬆️ Lascia il campo del valore vuoto per qualsiasi endpoint che desideri disabilitare.

⚠️ impostare le chiavi API e il token su user_provided ti consente di fornirli in modo sicuro dalla webUI

• Per CREDS_KEY, CREDS_IV e JWT_SECRET usa questo strumento: Generatore di credenziali
• Esegui lo strumento una seconda volta e utilizza il nuovo valore JWT_SECRET per JWT_REFRESH_SECRET

Deployment

1. Una volta terminato di compilare secrets e variables, fai clic su Duplicate Space nella parte inferiore di quella finestra

2. Il progetto verrà ora compilato, questo richiederà un paio di minuti

3. Quando è pronto, Building cambierà in Running

E potrai accedere a LibreChat!

Aggiornamento

Per aggiornare LibreChat, seleziona semplicemente Factory Reboot dal menu ⚙️Settings

Conclusione

Ora puoi accedervi dall'URL corrente. Se desideri accedervi senza l'overlay di Hugging Face, puoi modificare questo modello di URL con le tue informazioni:

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

ad es. https://cooluser-librechat.hf.space/

🎉 Congratulazioni, hai distribuito con successo LibreChat su Hugging Face! 🤗

Configurazione di Meilisearch (Opzionale)

Per abilitare la funzionalità di ricerca in LibreChat, è necessario distribuire e configurare un'istanza di Meilisearch. Ecco come fare:

1. Duplica lo Space di Meilisearch:

Visita questo link: https://huggingface.co/spaces/LibreChat/meilisearch e clicca su "Duplicate this Space".

2. Configurare lo spazio Meilisearch:

• Visibilità: Imposta la visibilità su "public".

• MEILI_MASTER_KEY: Genera una master key sicura di 16 caratteri. Puoi utilizzare uno strumento come https://randomkeygen.com/ per generare una chiave casuale. Imposta questa chiave come valore per la variabile d'ambiente MEILI_MASTER_KEY nello spazio Meilisearch. Importante: mantieni questa chiave al sicuro!

• MEILI_ENV: Imposta la variabile d'ambiente MEILI_ENV su production.

3. Duplica lo Space:

Fai clic sul pulsante "Duplicate Space".

4. Configura LibreChat per utilizzare Meilisearch:

• Modifica il Dockerfile: Vai nel tuo spazio LibreChat (quello che hai duplicato dal template principale di LibreChat). Vai su "Files" -> "Dockerfile" e clicca su "Edit".

• Decommenta e modifica le righe: Decommenta/modifica le seguenti righe nel Dockerfile. Queste righe conterranno ENV SEARCH e ENV MEILI_*. Assicurati di sostituire <YOUR_MEILISEARCH_SPACE_URL> con l'URL effettivo del tuo deployment di Meilisearch su Hugging Face Spaces. Dovrebbe apparire simile a https://<your-username>-meilisearch.hf.space/. Aggiorna il nome utente affinché corrisponda al tuo!

  ENV SEARCH=true
  ENV MEILI_NO_ANALYTICS=true
  ENV MEILI_HOST=<YOUR_MEILISEARCH_SPACE_URL>

• Commit Changes: Esegui il commit delle tue modifiche al branch main.

5. Aggiungi il segreto MEILI_MASTER_KEY a LibreChat:

• Vai alle impostazioni del tuo spazio LibreChat (il deployment di LibreChat, non quello di Meilisearch).

• Fai clic su "New secret".

• Nome: Inserisci MEILI_MASTER_KEY.

• Valore: Inserisci la stessa master key che hai utilizzato durante la configurazione dello spazio Meilisearch.

6. Verifica la configurazione:

Dopo che LibreChat è stato ricostruito e ha iniziato l'esecuzione, dovresti vedere un'opzione di ricerca in alto a sinistra nell'interfaccia di LibreChat. Se non la vedi, ricontrolla di aver seguito correttamente tutti i passaggi.