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

HuggingFace

Hugging Face SpacesでLibreChatを簡単にデプロイ

データベースの作成と設定 (必須)

最初に行う必要があるのは、MongoDB Atlasデータベースを作成し、接続文字列を取得することです。

このドキュメントの指示に従ってください: MongoDB Atlas

はじめに

1. Hugging Face にログインするか、アカウントを作成します。

2. https://huggingface.co/spaces/LibreChat/template にアクセスし、Duplicate this Space をクリックして、LibreChat テンプレートを自分のプロフィールにコピーします。

注: このテンプレートでランタイムエラーが発生するのは正常な動作です。機能させるには、以下のガイドに従って設定を行う必要があります。

image

3. スペースに名前を付け、Secrets と Variables を入力します

ここで公開するか非公開にするかを決定することもできます。

image

これらの値を入力する必要があります：

SecretsValues
MONGO_URI* 文字列を取得するには次の手順に従ってください: 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* 下記を参照
CREDS_IV* 下記を参照
JWT_SECRET* 下記を参照
JWT_REFRESH_SECRET* 下記を参照

⬆️ 無効にしたいendpointについては、valueフィールドを空のままにしてください。

⚠️ APIキーとトークンを user_provided に設定すると、WebUIから安全に提供できるようになります。

  • CREDS_KEY、CREDS_IV、および JWT_SECRET には、このツールを使用してください：Credentials Generator
  • ツールを2回実行し、新しい JWT_SECRET の値を JWT_REFRESH_SECRET に使用してください。
変数値
APP_TITLELibreChat
ALLOW_REGISTRATIONtrue

デプロイメント

1. secrets と variables の入力が完了したら、ウィンドウ下部にある Duplicate Space をクリックします。

image

2. プロジェクトのビルドが開始されます。これには数分かかります。

image

3. 準備が完了すると、Building が Running に変わります。

image

これでLibreChatにアクセスできるようになります！

image

アップデート

LibreChatをアップデートするには、⚙️SettingsメニューからFactory Rebootを選択するだけです。

image

結論

現在のURLからアクセスできるようになりました。Hugging Faceのオーバーレイなしでアクセスしたい場合は、このURLテンプレートを自身の情報で変更してください：

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

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

🎉 おめでとうございます。LibreChatをHugging Faceに正常にデプロイできました！ 🤗

Meilisearch セットアップ (オプション)

LibreChatで検索機能を有効にするには、Meilisearchインスタンスをデプロイおよび設定する必要があります。手順は以下の通りです：

1. Meilisearch Spaceを複製する:

以下のリンクにアクセスし: https://huggingface.co/spaces/LibreChat/meilisearch 「Duplicate this Space」をクリックしてください。

2. Meilisearchスペースの設定:

  • Visibility: 可視性を "public" に設定します。

  • MEILI_MASTER_KEY: 安全な16文字のマスターキーを生成します。https://randomkeygen.com/ のようなツールを使用してランダムなキーを生成できます。このキーをMeilisearchスペースの MEILI_MASTER_KEY 環境変数の値として設定してください。重要: このキーは安全に保管してください！

  • MEILI_ENV: MEILI_ENV 環境変数を production に設定します。

3. Spaceを複製する:

「Duplicate Space」ボタンをクリックします。

4. LibreChatでMeilisearchを使用するように設定する:

  • Dockerfileを編集する: LibreChatスペース（メインのLibreChatテンプレートから複製したもの）に移動します。「Files」->「Dockerfile」の順に移動し、「Edit」をクリックします。

  • 行のコメントアウト解除と修正: Dockerfile内の以下の行のコメントアウトを解除し、編集します。これらの行には ENV SEARCH および ENV MEILI_* が含まれています。<YOUR_MEILISEARCH_SPACE_URL> を、Hugging Face Spaces上のMeilisearchデプロイメントの実際のURLに置き換えてください。URLは https://username-meilisearch.hf.space/ のような形式になります。ユーザー名を自分のユーザー名に合わせて更新してください！

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

  • 変更をコミット: 変更を main ブランチにコミットします。

5. MEILI_MASTER_KEY シークレットを LibreChat に追加する:

  • LibreChatスペースの設定に移動します（Meilisearchではなく、LibreChatのデプロイメントの方です）。

  • 「New secret」をクリックします。

  • 名前: MEILI_MASTER_KEY を入力します。

  • 値: Meilisearchスペースをセットアップした際に使用した同じマスターキーを入力してください。

6. セットアップの確認:

LibreChatがリビルドされ実行を開始すると、LibreChatインターフェースの左上に検索オプションが表示されるはずです。もし表示されない場合は、すべての手順を正しく実行したか再確認してください。

このガイドはいかがでしたか？

GitHub で編集