HuggingFace

Buat dan Konfigurasi Database Anda (Wajib)

Hal pertama yang perlu Anda lakukan adalah membuat MongoDB Atlas Database dan mendapatkan connection string Anda.

Ikuti petunjuk dalam dokumen ini: MongoDB Atlas

Memulai

1. Masuk atau Buat akun di Hugging Face

2. Kunjungi https://huggingface.co/spaces/LibreChat/template dan klik Duplicate this Space untuk menyalin template LibreChat ke profil Anda.

Catatan: Adalah hal yang wajar jika templat ini mengalami error saat runtime, Anda harus mengonfigurasinya menggunakan panduan berikut agar dapat berfungsi.

3. Beri nama Space Anda dan isi Secrets serta Variables

Anda juga dapat memutuskan di sini untuk menjadikannya publik atau pribadi

Anda perlu mengisi nilai-nilai ini:

⬆️ Biarkan kolom nilai kosong untuk endpoint mana pun yang ingin Anda nonaktifkan.

⚠️ mengatur API keys dan token ke user_provided memungkinkan Anda untuk menyediakannya dengan aman dari webUI

• Untuk CREDS_KEY, CREDS_IV dan JWT_SECRET gunakan alat ini: Credentials Generator
• Jalankan alat tersebut untuk kedua kalinya dan gunakan nilai JWT_SECRET yang baru untuk JWT_REFRESH_SECRET

Deployment

1. Setelah Anda selesai mengisi secrets dan variables, klik Duplicate Space di bagian bawah jendela tersebut

2. Proyek sekarang akan melakukan build, proses ini akan memakan waktu beberapa menit

3. Saat siap, Building akan berubah menjadi Running

Dan Anda akan dapat mengakses LibreChat!

Pembaruan

Untuk memperbarui LibreChat, cukup pilih Factory Reboot dari menu ⚙️Settings

Kesimpulan

Anda sekarang dapat mengaksesnya dari URL saat ini. Jika Anda ingin mengaksesnya tanpa overlay Hugging Face, Anda dapat memodifikasi templat URL ini dengan informasi Anda:

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

contohnya https://cooluser-librechat.hf.space/

🎉 Selamat, Anda telah berhasil men-deploy LibreChat di Hugging Face! 🤗

Pengaturan Meilisearch (Opsional)

Untuk mengaktifkan fungsionalitas pencarian di LibreChat, Anda perlu men-deploy dan mengonfigurasi instance Meilisearch. Berikut caranya:

1. Duplikasi Meilisearch Space:

Kunjungi tautan ini: https://huggingface.co/spaces/LibreChat/meilisearch dan klik "Duplicate this Space".

2. Konfigurasi Ruang Meilisearch:

• Visibility: Atur visibilitas ke "public".

• MEILI_MASTER_KEY: Hasilkan master key 16 karakter yang aman. Anda dapat menggunakan alat seperti https://randomkeygen.com/ untuk menghasilkan kunci acak. Tetapkan kunci ini sebagai nilai untuk variabel lingkungan MEILI_MASTER_KEY di ruang Meilisearch. Penting: Jaga keamanan kunci ini!

• MEILI_ENV: Atur variabel lingkungan MEILI_ENV ke production.

3. Duplikat Space:

Klik tombol "Duplicate Space".

4. Konfigurasi LibreChat untuk menggunakan Meilisearch:

• Edit the Dockerfile: Buka ruang LibreChat Anda (ruang yang Anda duplikasi dari templat utama LibreChat). Navigasikan ke "Files" -> "Dockerfile" dan klik "Edit".

• Hapus komentar dan Ubah Baris: Hapus komentar/edit baris-baris berikut di Dockerfile. Baris-baris ini akan berisi ENV SEARCH dan ENV MEILI_*. Pastikan untuk mengganti <YOUR_MEILISEARCH_SPACE_URL> dengan URL sebenarnya dari deployment Meilisearch Anda di Hugging Face Spaces. Tampilannya akan terlihat seperti https://<your-username>-meilisearch.hf.space/. Perbarui nama pengguna agar sesuai dengan nama pengguna Anda!

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

• Commit Changes: Commit perubahan Anda ke branch main.

5. Tambahkan Secret MEILI_MASTER_KEY ke LibreChat:

• Buka pengaturan ruang LibreChat Anda (deployment LibreChat, bukan deployment Meilisearch).

• Klik "New secret".

• Nama: Masukkan MEILI_MASTER_KEY.

• Nilai: Masukkan master key yang sama dengan yang Anda gunakan saat menyiapkan space Meilisearch.

6. Verifikasi Pengaturan:

Setelah LibreChat membangun ulang dan mulai berjalan, Anda akan melihat opsi pencarian di kiri atas antarmuka LibreChat. Jika Anda tidak melihatnya, periksa kembali apakah Anda telah mengikuti semua langkah dengan benar.