活用のヒント
このページでは、Libre WebUI を毎日の利用でより速く、すっきりと、確実に使うための実践的なワークフローを紹介します。
日常用の小さなモデルを読み込んでおく
日常的な作業には高速なローカルモデルを使い、必要なときだけ大きなモデルへ切り替えます。
日常使いに適した例:
- 高速な普段のチャットには
gemma4:12b - より高度な汎用作業には
qwen3.8:27b - 高性能なハードウェアで MoE の効率を活かすには
gemma4:26b - dense 型ローカルモデルで最高の品質を得るには
gemma4:31b - ドキュメントの埋め込みには
nomic-embed-text
Models を開くと、実行中のモデルを確認できます。VRAM が足りなくなったら、使用していないモデルをアンロードしてください。
保存したくない会話にはシークレットチャットを使う
タブバーの + メニュー、コマンドパレット、ホームページ、またはチャットのウェルカム画面にある
ゴーストボタンからシークレットチャットを開始できます。直接開く URL は /chat?incognito=1 です。
シークレットチャットは一切永続化されません。サーバーにセッションを作成せず、メッセージを保存せず、 サイドバーや履歴にも表示されません。チャットには プライベートモード のバナー (「この会話は保存されません」)が表示されます。保存済みのチャットを開くとシークレットモードが終了します。 シークレットタブを再読み込みすると新しい空のプライベートチャットが始まり、それまでの会話は失われます。
境界を正しく理解してください。シークレットモードが制御するのは永続化であり、プロバイダーへの送信ではありません。 選択したモデルがローカルかリモートかにかかわらず、モデルには会話全体が送信されます。ドキュメントのコンテキストを 有効にしている場合は、それも適用されます。インフラの外へ出してはいけない会話では、シークレットモードと ローカル Ollama モデルを組み合わせてください。
コンテキストメニューでタブを管理する
タブを右クリックするか、フォーカスしたタブで Shift + F10 を押すと、次の操作を選べます。
- タブを閉じる
- ほかのタブを閉じる
- 右側のタブを閉じる
- すべてのタブを閉じる
ホームは常に最初のタブで、閉じることはできません。管理者の場合は + メニューから
ユーザー管理、システム、プロバイダー使用量へ直接移動できます。さらに、アバターメニューの
ピンアイコンを使って 3 項目のいずれかをサイドバー下部(設定の横)に固定できるため、以後はメニューを開く必要がありません。
コマンドパレットで素早く移動する
Cmd/Ctrl + K を押すと、入力欄にフォーカスがあるときも含め、どこからでもコマンドパレットが開きます。
アプリの操作、チャット、Work タスクをあいまい検索するため、途中までの入力やスペルミスでも見つかります。
たとえば autmtn で Automations、「pictures」で Imagine、「dark」でテーマ切り替えが見つかります。
3 文字以上入力すると、メッセージ、ノート、ドキュメントの内容(共有されたノートを含む)も検索し、
一致ごとに抜粋を表示します。この検索はメモリ上にある自分の復号済みデータを対象に実行され、
ディスク上に平文のインデックスを作成することはありません。一致した文字は強調表示され、
結果は関連度順に並びます。何も入力しなければ、最近のチャットとタスクが表示されます。
↑/↓ で移動し、Enter で開き、Esc(または再度 Cmd/Ctrl + K)で閉じます。
テーマの既定値
新規インストールではダークテーマが使われ、最初の描画前に適用されるため、明るい画面が一瞬表示されることはありません。
管理者は 設定 > ユーザー管理 > デフォルトテーマ(ライト、ダーク、ピュアブラック)からインスタンス全体の既定値を変更できます。
この既定値はサインインページに適用され、新規アカウントの初期値になり、テーマを自分で選んでいないブラウザにも適用されます。
保存済みの個人設定は常に尊重されます。Libre WebUI は OS のテーマ設定には追従しません。
Cmd/Ctrl + D、太陽/月のボタン、または設定画面から明示的に切り替えてください。
このトグルはライト、ダーク、ピュアブラック、セレスティアルを順に切り替えます。
セレスティアル は太陽の動きに従います。配色と実際の空(弧を描く太陽や月、雲、日没後の星、 夜間はポインターを追うランプ)が分単位で変化し、日の出と日の入りも一年を通して移動します。 設定 > 外観 で選択できます。そこにある 時刻 のスライダーで一日のどの時刻でもプレビューでき、 時計に合わせる で実際の時刻に戻ります。位置情報がない場合は中緯度の一日を想定します。 位置情報を共有する(または座標を入力する)と、日の出と日の入りが実際の空に合わせて計算されます。 位置情報は約 1 km に丸められ、そのブラウザーにのみ保存され、サーバーへ送信されることはありません。 位置情報があれば 天気に合わせる も有効にできます。現在の気象状況は Open-Meteo からブラウザーへ 直接届き、雲、雨、雪、霧、風が空の見え方を形づくります。
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 を渡します。
知っておくべき点が 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 に表示させてください。アプリが生成する一覧でない限り、長いプロバイダーカタログをドキュメントへコピーしないでください。