HuggingFace

Veritabanınızı Oluşturun ve Yapılandırın (Gerekli)

İhtiyacınız olan ilk şey bir MongoDB Atlas Veritabanı oluşturmak ve bağlantı dizenizi (connection string) almaktır.

Bu belgedeki talimatları izleyin: MongoDB Atlas

Başlarken

1. Hugging Face üzerinde oturum açın veya bir hesap oluşturun

2. https://huggingface.co/spaces/LibreChat/template adresini ziyaret edin ve LibreChat şablonunu profilinize kopyalamak için Duplicate this Space seçeneğine tıklayın.

Not: Bu şablonun bir çalışma zamanı hatası vermesi normaldir, işlevsel hale getirmek için aşağıdaki kılavuzu kullanarak yapılandırmanız gerekecektir.

3. Alanınızı (Space) adlandırın ve Secrets ile Variables kısımlarını doldurun

Burada ayrıca herkese açık veya özel yapmaya da karar verebilirsiniz

Bu değerleri doldurmanız gerekecek:

⬆️ Devre dışı bırakmak istediğiniz tüm endpoint'ler için değer alanını boş bırakın.

⚠️ API anahtarlarını ve token'ı user_provided olarak ayarlamak, bunları webUI üzerinden güvenli bir şekilde sağlamanıza olanak tanır

• CREDS_KEY, CREDS_IV ve JWT_SECRET için bu aracı kullanın: Credentials Generator
• Aracı ikinci kez çalıştırın ve JWT_REFRESH_SECRET için yeni JWT_SECRET değerini kullanın

Dağıtım

1. secrets ve variables kısımlarını doldurmayı bitirdiğinizde, pencerenin alt kısmındaki Duplicate Space düğmesine tıklayın

2. Proje şimdi derlenecek, bu işlem birkaç dakika sürecektir

3. Hazır olduğunda, Building ifadesi Running olarak değişecektir.

Ve LibreChat'e erişebileceksiniz!

Güncelleme

LibreChat'i güncellemek için ⚙️Settings menüsünden Factory Reboot seçeneğini seçmeniz yeterlidir.

Sonuç

Artık mevcut URL üzerinden erişebilirsiniz. Hugging Face katmanı olmadan erişmek isterseniz, bu URL şablonunu kendi bilgilerinizle değiştirebilirsiniz:

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

örneğin https://cooluser-librechat.hf.space/

🎉 Tebrikler, LibreChat uygulamasını Hugging Face üzerinde başarıyla dağıttınız! 🤗

Meilisearch Kurulumu (İsteğe bağlı)

LibreChat'te arama işlevini etkinleştirmek için bir Meilisearch örneği dağıtmanız ve yapılandırmanız gerekir. İşte nasıl yapılacağı:

1. Meilisearch Space'i kopyalayın:

Bu bağlantıyı ziyaret edin: https://huggingface.co/spaces/LibreChat/meilisearch ve "Duplicate this Space" seçeneğine tıklayın.

2. Meilisearch Alanını Yapılandırın:

• Görünürlük: Görünürlüğü "public" olarak ayarlayın.

• MEILI_MASTER_KEY: Güvenli, 16 karakterlik bir ana anahtar oluşturun. Rastgele bir anahtar oluşturmak için https://randomkeygen.com/ gibi bir araç kullanabilirsiniz. Bu anahtarı, Meilisearch alanındaki MEILI_MASTER_KEY ortam değişkeni için değer olarak ayarlayın. Önemli: Bu anahtarı güvende tutun!

• MEILI_ENV: MEILI_ENV ortam değişkenini production olarak ayarlayın.

3. Space'i kopyalayın:

"Duplicate Space" düğmesine tıklayın.

4. LibreChat'i Meilisearch kullanacak şekilde yapılandırın:

• Dockerfile dosyasını düzenleyin: LibreChat alanınıza (ana LibreChat şablonundan kopyaladığınız alan) gidin. "Files" -> "Dockerfile" yolunu izleyin ve "Edit" düğmesine tıklayın.

• Satırların Yorumunu Kaldırın ve Düzenleyin: Dockerfile içindeki aşağıdaki satırların yorumunu kaldırın/düzenleyin. Bu satırlar ENV SEARCH ve ENV MEILI_* ifadelerini içerecektir. <YOUR_MEILISEARCH_SPACE_URL> kısmını, Hugging Face Spaces üzerindeki Meilisearch dağıtımınızın gerçek URL'si ile değiştirdiğinizden emin olun. Bu, https://<your-username>-meilisearch.hf.space/ gibi görünmelidir. Kullanıcı adınızı kendi kullanıcı adınızla eşleşecek şekilde güncelleyin!

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

• Değişiklikleri İşle: Değişikliklerinizi main dalına (branch) işleyin.

5. MEILI_MASTER_KEY Gizli Anahtarını LibreChat'e Ekleyin:

• LibreChat alanınızın ayarlarına gidin (Meilisearch dağıtımı değil, LibreChat dağıtımı).

• "New secret" öğesine tıklayın.

• Ad: MEILI_MASTER_KEY girin.

• Değer: Meilisearch alanını kurarken kullandığınız aynı ana anahtarı (master key) girin.

6. Kurulumu Doğrulayın:

LibreChat yeniden oluşturulup çalışmaya başladıktan sonra, LibreChat arayüzünün sol üst köşesinde bir arama seçeneği görmelisiniz. Eğer göremiyorsanız, tüm adımları doğru bir şekilde takip ettiğinizden emin olun.