活用のヒント
このページでは、Libre WebUI を毎日の利用でより速く、すっきりと、確実に使うための実践的なワークフローを紹介します。
日常用の小さなモデルを読み込んでおく
日常的な作業には高速なローカルモデルを使い、必要なときだけ大きなモデルへ切り替えます。
日常使いに適した例：
- 高速な普段のチャットには
gemma4:12b - より高度な汎用作業には
qwen3.8:27b - 高性能なハードウェアで MoE の効率を活かすには
gemma4:26b - dense 型ローカルモデルで最高の品質を得るには
gemma4:31b - ドキュメントの埋め込みには
nomic-embed-text
Models を開くと、実行中のモデルを確認できます。VRAM が足りなくなったら、使用していないモデルをアンロードしてください。
応答の実行中に新しいチャットへ名前を付ける
設定 → デフォルト で 自動タイトル を有効にし、タスクモデル を選びます。新しく保存されるチャットでは、 最初のメッセージを送信した時点で、アシスタントの応答と並行してタイトル生成がその内容を要約します。 タイトルが用意できるとサイドバーが更新されます。タイトル要求が遅くても、応答が止まることはありません。
タイトル要求は、選択したタスクモデルとそのプロバイダーが処理します。要求を直列化するプロバイダーでは、 順番待ちになる場合があります。以降のメッセージ、すでに名前が付いているチャット、シークレットチャットでは 自動タイトルは実行されません。
リアルタイムの思考を追う
設定 → デフォルト で 自動タイトル が有効になっていて タスクモデル が選ばれている場合、 折りたたまれた思考ブロックに、アシスタントが推論している間の短い活動サマリーが表示されます。 同じタスクモデルが最新の推論の抜粋を受け取って現在の話題を説明するため、そのテキストを自分のマシンから 出したくない場合はローカルモデルを選んでください。
サマリーが使うのは最新の最大 4,000 文字で、十分なテキストが集まってから開始し、更新は 5 秒に 1 回まで、 同時に実行される要求は 1 件だけです。サマリーが遅れても失敗しても、回答が止まることはありません。 思考が終わった後も、最後のサマリーはその描画済みメッセージに所要時間とともに表示され続けます。 元の推論を読むにはブロックを展開してください。これらのサマリーは一時的なもので、チャット履歴には 保存されません。
活動テキストは変化に合わせてアニメーションし、保留中のチャットタイトルと同じ読み込み表示を使います。 視差効果を減らす設定では、どちらのアニメーションも無効になります。シークレットチャットと、 タスクモデルが有効になっていないチャットでは、サマリー要求を行わず通常の思考ラベルのままになります。
保存したくない会話にはシークレットチャットを使う
タブバーの + メニュー、コマンドパレット、ホームページ、またはチャットのウェルカム画面にある
ゴーストボタンからシークレットチャットを開始できます。直接開く URL は /chat?incognito=1 です。
シークレットチャットは一切永続化されません。サーバーにセッションを作成せず、メッセージを保存せず、 サイドバーや履歴にも表示されません。チャットには プライベートモード のバナー （「この会話は保存されません」）が表示されます。保存済みのチャットを開くとシークレットモードが終了します。 シークレットタブを再読み込みすると新しい空のプライベートチャットが始まり、それまでの会話は失われます。
境界を正しく理解してください。シークレットモードが制御するのは永続化であり、プロバイダーへの送信ではありません。 選択したモデルがローカルかリモートかにかかわらず、モデルには会話全体が送信されます。ドキュメントのコンテキストを 有効にしている場合は、それも適用されます。インフラの外へ出してはいけない会話では、シークレットモードと ローカル Ollama モデルを組み合わせてください。
コンパクトサイドバーを使う
コンパクトサイドバーには、Chat と Work の下に Channels、Notes、Calendar、Automations、Personas、 Imagine への直接のショートカットが並び、最後に Search が入ります。アカウントで有効になっている場合は、 Agents のショートカットも表示されます。アイコンにポインターを合わせるとラベルが表示され、 現在の移動先はハイライトされたままになります。画面の高さが足りない場合はショートカットをスクロールでき、 設定とアカウントの操作は下部に残ります。
パネルをスクロールする
Chat と Work のリストは、さらに項目がある端でやわらかくフェードします。リストの先頭や末尾では フェードが消え、すべて収まるリストは常に完全に表示されます。キーボードフォーカスがあるときは リストがはっきり表示され、コントロールが読みやすいままになります。
上部のタブバーも、水平スクロールの端で同じフェードを使います。すべてのタブが収まっている場合や どちらかの端に達した場合、フェードは消えます。タブを選択するとそのタブが見える位置まで表示され、 新しいタブのボタンはタブ列の横に常に完全な状態で表示されます。
同じ効果は、設定、Chat、Work、ライブラリのページ、メニュー、ダイアログの内容でのスクロールにも 適用され、横方向のリストや表も対象です。設定では、タイトルと検索欄がスクロールするナビゲーションの 上に残ります。フェードはコンテンツの読み込み、フィルターの変更、ウィンドウのサイズ変更に合わせて 更新され、すべてのテーマと右から左へのレイアウトで機能します。キーボード操作中はフォーカスされた コントロール周辺のフェードが消え、マウスやタッチに戻すと元に戻ります。テキスト入力欄と、埋め込み アプリやターミナル／エディターウィジェットの内部は、それぞれ独自の表示のままです。
Chat と Work では、上へスクロールしたときに、上部の古いコンテンツと 新しいメッセージ、 新しいアクティビティ の各ボタンの下により広いフェードを使います。これらのボタンはフェードした 文字の上ではっきり表示され、押すと最新のコンテンツに戻り、そこでは下部のフェードが消えます。
コンテキストメニューでタブを管理する
タブを右クリックするか、フォーカスしたタブで Shift + F10 を押すと、次の操作を選べます。
- タブを閉じる
- ほかのタブを閉じる
- 右側のタブを閉じる
- すべてのタブを閉じる
ホームは常に最初のタブで、閉じることはできません。管理者はアバターメニューのピンアイコンを使って、 システム、プロバイダーの使用状況、評価をサイドバー下部に固定できます。ユーザーの管理は 設定 → ユーザー管理 にあります。
コマンドパレットで素早く移動する
Cmd/Ctrl + K を押すと、入力欄にフォーカスがあるときも含め、どこからでもコマンドパレットが開きます。
アプリの操作、チャット、Work タスクをあいまい検索するため、途中までの入力やスペルミスでも見つかります。
たとえば autmtn で Automations、「pictures」で Imagine、「dark」でテーマ切り替えが見つかります。
3 文字以上入力すると、メッセージ、ノート、ドキュメントの内容（共有されたノートを含む）も検索し、
一致ごとに抜粋を表示します。この検索はメモリ上にある自分の復号済みデータを対象に実行され、
ディスク上に平文のインデックスを作成することはありません。一致した文字は強調表示され、
結果は関連度順に並びます。何も入力しなければ、最近のチャットとタスクが表示されます。
↑/↓ で移動し、Enter で開き、Esc（または再度 Cmd/Ctrl + K）で閉じます。
テーマの既定値
新規インストールではダークテーマが使われ、最初の描画前に適用されるため、明るい画面が一瞬表示されることはありません。
管理者は 設定 > ユーザー管理 > 既定の設定 > デフォルトテーマ（ライト、ダーク、ピュアブラック）からインスタンス全体の既定値を変更できます。
この既定値はサインインページに適用され、新規アカウントの初期値になり、テーマを自分で選んでいないブラウザにも適用されます。
保存済みの個人設定は常に尊重されます。Libre WebUI は OS のテーマ設定には追従しません。
Cmd/Ctrl + D、太陽／月のボタン、または設定画面から明示的に切り替えてください。
このトグルはライト、ダーク、ピュアブラック、セレスティアルを順に切り替えます。
セレスティアル は太陽の動きに従います。配色と実際の空（弧を描く太陽や月、雲、日没後の星、 夜間はポインターを追うランプ）が分単位で変化し、日の出と日の入りも一年を通して移動します。 設定 > 外観 で選択できます。タブバーの端にある空の時計を押すと、ガラス調のプレビューが開きます。 一日を横方向にドラッグすると太陽と月が動き、日の出 や 日の入り に直接移動することもできます。 同じプレビューは外観からも利用できます。プレビューでは リアルタイム の時刻と手動で選んだ プレビュー の時刻が区別され、スライダーに沿って時刻ラベルが表示されます。時計に合わせる、プレビューを閉じる、または外観から 離れると実際の時刻に戻ります。一日をたどる操作はローカルで動作し、新しいテーマ設定は保存されません。 位置情報がない場合は中緯度の一日を想定します。 位置情報を共有する（または座標を入力する）と、日の出と日の入りが実際の空に合わせて計算されます。 位置情報は約 1 km に丸められ、そのブラウザーにのみ保存され、サーバーへ送信されることはありません。 座標を手入力する場合は 緯度 と 経度 のラベルが表示されます。緯度は -90 から 90 の範囲、 経度は -180 から 180 の範囲でなければなりません。適用 または Enter で有効な座標を保存します。 無効な入力や未入力の場合は保存済みの位置情報がそのまま維持され、クリア を選んだときだけ 明示的に削除されます。 位置情報があれば 天気に合わせる も有効にできます。現在の気象状況は Open-Meteo からブラウザーへ 直接届き、雲、雨、雪、霧、風が空の見え方を形づくります。取得に失敗した場合、Libre はこのセッションで 最後に成功した天気を保持し、セレスティアルテーマが有効な間は自動的に再試行します。再試行は 15 秒後に 始まり、障害が続く間は最大でも 5 分に 1 回まで間隔が広がります。10 秒応答がない要求は取り消され、 その後の更新を妨げません。天気をオフにするか位置情報を変更すると、保留中の要求は取り消されます。
セレスティアルはチャットと Work で同じガラス調の入力欄を使用します。太陽と月の位置は画面サイズに 合わせて拡大縮小され、ポインターの光は常に文字を読む面の下に留まります。タブが非表示になると 装飾的な動きは一時停止し、システムの視差効果を減らす設定にも即座に反応します。テーマ切り替え時の スイープ演出も同様です。
アカウントの壁紙
設定 > 外観 > 背景画像 で、10 MB までの画像を選択できます。元の画像と設定はアカウントに保存 されます。壁紙はホームとチャット、Work に表示され、サイドバー、タブバー、ライブラリのページには 描画されません。
ディザリング は、画像の色をもとに輪郭のはっきりした四角いピクセルを作り、暗い部分には隙間を 残します。明るい領域は点を作る前に和らげられるため、淡い空や明るい写真も一様な塗りつぶしにならず、 質感が保たれます。オリジナル は滑らかな画像をそのまま使い、ぼかし では和らげる度合いを 調整できます。3 つのスタイルはいずれも現在のテーマになじみ、読みやすさのためにハイライトを調整 します。アップロードした元画像が変更されることはありません。強度 はすぐにプレビューに反映され、 調整をやめた時点で保存されます。強度をゼロにすると、壁紙は削除されずに非表示になります。一時的に 無効化したり、差し替えたり、削除したりすることもできます。
プレビューはライト、ダーク（グレー）、ピュアブラック、セレスティアルのいずれでも動作します。 ナビゲーションを展開または折りたたんでも、壁紙は表示されたままです。スマートフォンでは、 サイドバーがコンテンツの一部を覆いますが、覆われていない部分の壁紙は表示され続けます。Personas の背景はそれぞれのチャット専用のままで、アカウントの壁紙を置き換える ことはありません。画像処理はブラウザー内で実行されます。外部の画像がオリジンポリシーのために 処理できない場合は、ローカルの代替表示が使われます。
メンションと自動化の結果をメールで受け取る
管理者が設定 → ユーザー管理 → アクセスとポリシーで送信メールサーバーを設定したら、設定 → 通知 を開いてチャンネルでのメンション、自動化の実行結果、またはその両方をオンにします。メンションは メッセージのプレビューとチャンネルへのリンクとともに届き、自動化の実行結果は生成された返信（失敗した 場合はエラー内容）と、結果のチャットまたは Work タスクへのリンクとともに届きます。どちらもオンにする までは無効で、アカウントにメールアドレスが登録されている必要があります。
Work タスクの対象を絞る
プロジェクトまたは独立した目標ごとに、別の Work タスクを使用してください。各タスクには専用の会話、 管理されたコンテナ ID、永続ファイルがあります。コンテナ自体を停止または再作成しても名前付きボリュームは残るため、 同じタスクを再利用すれば有用なコンテキストを維持でき、新しいタスクを始めれば明確な境界を作れます。
最初の指示には、次の情報を含めると効果的です。
- 求める結果。
- 重要な技術上または設計上の制約。
- 完了を検証するコマンドまたは動作。
- 変更してはいけないファイルまたはインターフェース。
アクティビティ で進捗を確認し、ファイル、Git、ターミナル、プレビュー で結果を調べてテストします。
ファイルエディターはライト/ダークテーマの構文強調、ブラウザーに保存される未保存の下書き、対応ファイル形式の
フォーマットをサポートします。Cmd/Ctrl + S で保存し、Shift + Alt + F でフォーマットします。
モデルへの通信を設定済みの Ollama インフラ内に留めたい場合は、インストール済みのツール対応 Ollama モデルを使用します。 リモートまたはクラウドモデルならローカル推論のメモリ負荷を減らせますが、有料呼び出しが複数回行われる可能性があり、 ワークスペースデータを含む場合がある、要求されたツール結果が送信されます。
実行またはプレビューを停止してもワークスペースは保持されます。Work タスクを削除するとワークスペースも完全に削除されるため、 先に必要なものをコピーしてください。
繰り返す作業には Personas を使う
繰り返し使うワークフローには Persona を作成します。
- temperature を低く設定した簡潔なコードレビュー担当。
- 明確なスタイルガイドを持つ文章編集担当。
- ドキュメント検索を有効にした調査アシスタント。
- トーンと応答形式を固定したサポートアシスタント。
Personas には、選択したモデル、system prompt、生成パラメーター、avatar/background、および任意の memory/mutation 設定が保存されます。JSON としてエクスポートおよびインポートすることもできます。
作業のそばに長期保存する Notes を置く
1 つのチャットや Work タスクから独立して情報を残す場合は、作成メニューから Notes を開きます。 Notes は Markdown プレビュー、明示的な編集、検索、自動保存に対応します。ノートに埋め込んだインライン SVG と 基本的な HTML もプレビューできますが、スクリプト、イベントハンドラー、安全でない URL が実行されないよう サニタイズされます。ノートツールのドロワーには、復元対応のリビジョン履歴、ファイル添付、ピン留め、 ユーザー単位の共有（閲覧または編集）、Markdown エクスポート、AI 編集サイドバーがあります。 AI の提案は適用前にすべて diff でプレビューされ、適用前に以前のバージョンがスナップショットされるため、 どの AI 編集も元に戻せます。Notes はアカウント単位で、ユーザー全体のアーカイブに含まれます。 リビジョン履歴と添付ファイルはインスタンス上に残り、アーカイブには含まれません。
Artifacts の信頼性を高める
Libre WebUI は、明示的な artifact タグ、fenced code block、単独の HTML ドキュメント、一般的な複数ファイルの HTML bundle を検出します。モデルから最適な artifact 出力を得るには、次のように依頼します。
Create one complete self-contained HTML file.
Inline the CSS and JavaScript.
Do not rely on external files unless they are CDN URLs.
ブロックを分ける場合は、それぞれに分かりやすい名前を付けます。
```html filename="index.html"
...
```
```css filename="style.css"
...
```
```js filename="app.js"
...
```
Libre WebUI は、ローカルの CSS と JavaScript ブロックを HTML プレビューにまとめようとします。
応答のストリーミング中にプロンプトをキューへ入れる
生成中に送信したプロンプトは破棄されず、キューに入ります。キュー内のプロンプトは入力欄の上に表示され、 編集、並べ替え、削除が可能です。各応答が完了するたびに 1 件ずつ送信されます。キューはチャットとともに保存されるため、 再読み込みや再接続をまたいで維持されます。
会話をフォークする
任意のメッセージにあるフォークボタンを押すと、その時点までの会話が variants を含めて新しいチャットへコピーされ、 コピー元も記録されます。元のチャットは変わらないため、脇道の検討で本筋のスレッドが乱れることはありません。
1 回で複数のモデルを比較する
ツール選択の横にある columns ボタンを使うと、次のプロンプトを最大 3 つの追加モデルへ同時に送信できます。 各応答は独立した生成として、固有のモデルラベル、統計、キャンセル操作を持つため、遅いモデルや失敗したモデルが ほかのモデルを妨げることはありません。
ドキュメントチャットを目的に合わせて使う
ドキュメントチャットでは、最大 10 MB の PDF、Office（DOCX/PPTX/XLSX）、Markdown、HTML、コード、CSV ファイルを使用できます。検索には 2 つのモードがあります。
- キーワード検索（BM25）は常に利用できます。
- 設定で埋め込みを有効にし、埋め込みモデルを利用できる場合、ハイブリッド検索がセマンティック検索とキーワード検索の順位を統合します。
手軽なローカル埋め込みモデルには nomic-embed-text をインストールします。
ollama pull nomic-embed-text
最適な結果を得るには、巨大で雑多な 1 つのドキュメントセットではなく、チャットごとに対象を絞ったドキュメントをアップロードしてください。
生成設定を調整する
| 設定 | 実用的な使い方 |
|---|---|
| Temperature | 正確さを重視するなら低く、創造的な検討なら高くする |
| Top P / Top K | 意図して sampling を調整する場合以外は既定値のままにする |
| Context window | モデルとメモリに余裕がある場合のみ、長いチャットで増やす |
| Max tokens | 長い応答を制限するか、コード/artifact の生成では増やす |
| Repeat penalty | モデルが同じ内容を繰り返す場合に少し上げる |
モデルの動作が悪いときは、まず temperature を下げ、次に context の負荷を減らし、それでも直らなければ別のモデルを試します。
モデルの思考量を決める
入力欄のモデル名の横にあるコントロールから、reasoning のレベル off、on、low、 medium、high を選べます。選択内容は会話に属するため、再読み込み後も保持され、再生成にも適用されます。 Settings > Generation には新しい応答の既定値があり、チャットコントロールパネルにも同じ値が表示されます。
未設定のままにすると何も送信されません。これは、このリリースより前のすべてのバージョンと同じ動作です。
設定すると、応答するプロバイダーに合わせてサーバーが 1 つの値を変換します。Ollama にはリクエストボディで渡し、
OpenAI 形式のプロバイダーには reasoning effort を、Anthropic と Gemini には応答用の余裕を残した token budget を渡します。Claude Sonnet 5.5 と Opus 5.5 は budget を受け取りません。これらは適応的に思考し、名前付きレベルは effort 設定になり、Sonnet 5.5 でオフにすると、Anthropic の between_tools モードにより最初の思考はオフのままになります。Opus 5.5 にはオフのスイッチがないため、オフにすると既定の状態のままになります。
知っておくべき点が 2 つあります。Ollama が reasoning 非対応と報告するモデルには設定自体が送信されないため、 そのモデルではコントロールが表示されません。また、名前付きレベルが存在するのは gpt-oss など、それを公開している モデルだけです。レベルなしで reasoning するモデルでは、名前付きレベルはいずれも単に on として動作するため、 チャットでモデルを切り替えてもエラーになりません。global または pinned の既定値が設定されている場合、入力欄のボタンには 次の応答で実際に使われるレベルが表示され、「Default」項目には現在解決される値が示されます。
コンテキストウィンドウを監視する
会話が長くなると、モデル名の横にあるリングが埋まっていきます。カーソルを合わせると、ウィンドウの使用率、 使用済み token 数、比較対象となるウィンドウサイズが表示されます。5 分の 4 を超えると amber、上限に達すると red になり、 ウィンドウサイズが不明なモデルでは空のリングではなく破線のリングが表示されます。
カウントの対象は、次のリクエストで実際に送信される内容です。圧縮済みの履歴と放棄した分岐は消費しません。
プロバイダーが前回の応答で使用量を報告した場合はその値を起点とし、以降に会話へ追加された内容は 1 token あたり
4 文字として推定します。測定値がまだなければ ~ が表示されます。モデルの学習時より低い上限を設定した場合は、
その旨も表示されます。メーターが測るのはリクエストで実際に使われるウィンドウであり、モデルの学習時の全長ではなく、
既定で 32,768 の OLLAMA_MAX_CONTEXT です。この変数を増やすと、実際のウィンドウとメーターの両方に反映されます。
プロバイダーモデルでは、モデル一覧がウィンドウサイズを公開している場合にのみウィンドウが表示されます。 公開していない場合も token は数えますが、割り算の基準がないため使用率は表示できません。
長いチャットを自動的に圧縮する
管理者は Settings > Generation で context compaction を有効にできます。会話の推定 context が token threshold を超えると、 サーバーはモデルに古いメッセージの要約を依頼し、直近のメッセージだけを原文のまま保持します。要約は、履歴をまとめた位置に conversation-summary card として表示され、要約済みメッセージは薄く表示されます。内容は引き続き読めますが、モデルには送信されません。 compaction を有効にすると、「recent messages kept」の数が、会話で送信される rolling window にもなります。そのため、 この値を増やすとモデルが実際に参照する範囲が広がります。
| 設定 | 制御する内容 |
|---|---|
| Token threshold | compaction を開始する推定 context size |
| Recent messages kept | 直近の何件を常に原文のまま保持するか |
| Compaction model | 要約を作成するモデル。既定では会話自体のモデル |
| Custom summary prompt | {{PREVIOUS_SUMMARY}} と {{MESSAGES}} を含む独自の指示 |
Compaction は既定で無効で、サーバー上のすべてのユーザーに適用されますが、各チャットでも選択できます。 チャットコントロールパネルから 1 つの会話だけ compaction を無効にでき、すべての summary card に undo があります。 復元すると、その要約が置き換えたメッセージだけが compaction 1 回分ずつ正確に再び有効になります。 ターンの途中で分割されることはなく、原文のまま保持されるメッセージは必ず自分のメッセージから始まります。 新しい compaction では以前の summary も新しい要約へまとめられるため、会話が持つ running summary は 1 つです。 要約モデルが失敗した場合も処理は止まらず、圧縮前の履歴を使って生成が続行されます。
プロバイダーキーをユーザーごとに管理する
プロバイダープラグインは環境変数のキーを読み取れますが、共有環境では通常、ユーザー単位の認証情報の方が管理しやすくなります。 各ユーザーが自分のプロバイダーアクセスを管理できるよう、設定画面でキーを追加してください。
デプロイ全体の既定値または自動インストールには、バックエンドの環境変数を使用します。
リモートアクセスを予測しやすくする
スマートフォンや LAN からアクセスする場合は、dev server をネットワークインターフェースへバインドします。
npm run dev:host
別の端末から、マシンの LAN または Tailscale IP の ポート 8080 を開きます（dev:host のフロントエンドは
Vite の既定値ではなく 8080 で動作します）。本番環境では、ブラウザーが localhost にフォールバックしないよう、
CORS_ORIGIN とフロントエンドの API URL を明示的に設定してください。
アプリを離れずにバージョンを確認する
設定 → About では、ビルドを最新の GitHub Release と比較します。最新ならその旨を表示し、古ければリリースページへリンクし、
-dev ビルドが固定リリースより先行している場合も通知します。同じ行の View changelog ボタンを押すと、アップグレード後に
表示されたリリースノートを再び開けます。Libre WebUI が役立っているなら、そこにある Star on GitHub リンクを使うのが、
ほかの人に見つけてもらう最も簡単な方法です。
ドキュメントと UI の内容を揃える
製品は急速に変化します。動作とワークフローを説明する長く使えるドキュメントを優先し、プロバイダーの最新モデル一覧は UI に表示させてください。アプリが生成する一覧でない限り、長いプロバイダーカタログをドキュメントへコピーしないでください。