メインコンテンツへスキップ
ClipsXはAIなしでも使えます。埋め込みモデルは意味からクリップを検索し、生成モデルはRecallの回答や対応するAI拡張機能の文章を生成します。チャットモデルが埋め込みにも対応するとは限りません。Ollamaのインストールとモデルのダウンロードは利用者が行います。

開発者の構成から始める

開発者は意味検索に bge-m3:latest、生成に gemma3:4b を使っています。具体的な出発点であり、すべての端末での性能を保証するものではありません。
1

Ollamaをインストールして起動

公式ダウンロードのOS別手順に従って起動してください。既定のローカル接続先は http://localhost:11434 です。すでにサービスが動作している場合、二重に起動しないでください。
2

モデルをダウンロード

ClipsXと同じ端末のターミナルで実行します。
一覧にモデル名があることを確認します。検索だけならGemmaは不要です。ダウンロードにはインターネットが必要ですが、ローカル推論にはインストール済みのモデルを使います。
3

ClipsXを接続

インテリジェンス → モデルで新しい接続を作り、Ollamaと http://localhost:11434 を指定します。保存して接続テストとモデルの検出を行います。モデルを追加したら接続情報を更新してください。
4

必要な機能を有効化

bge-m3:latest のテキスト埋め込み用プリセットと、gemma3:4b のチャット用プリセットを追加します。用途と既定値の画面で、意味検索、Recall、拡張機能の文章生成にそれぞれ割り当てます。埋め込み設定の検証後、対象クリップをバックグラウンドで索引化します。
次は意味検索の練習、Recallの練習、Rewriteの変換を試してください。意味検索の索引作成中も通常のテキスト検索は使えます。

埋め込みモデルを選ぶ

検索用のベクトルを作るモデルです。回答の文章は生成しません。ClipsXはOllamaが埋め込み対応と報告するモデルを表示し、有効化時に出力を検証します。 代替モデルは評価する候補であり、ClipsXで独立した性能比較を済ませた構成ではありません。いずれかをダウンロードし、モデル一覧を更新して選びます。
埋め込みモデルを変えるとベクトル空間も変わります。ClipsXは代わりの索引を作成します。作成中は既存の有効な索引が使われる場合があります。比較は置き換えが完了してから行ってください。

生成モデルを選ぶ

文章を生成するモデルです。Recallは選択したモデルとプロバイダーが対応していれば、画像コンテキストやツールを使えます。拡張機能の文章生成は別に割り当てます。モデル名だけでは対応能力は判断できません。 例:
接続情報を更新し、チャット用プリセットを追加・更新して、用途と既定値の画面で割り当てます。引用付きのRecallと短いRewriteを試し、内容、誤り、待ち時間、資源使用量を比較してください。チャット用プリセットの変更に意味検索の再索引化は不要です。 公式一覧の確認日: 2026年10月8日。タグや要件は変わることがあります。各リンクでサイズ、必要なOllamaバージョン、ライセンスを確認してください。モデルのライセンスはClipsXのApache 2.0とは別です。問題報告には正確なタグと ollama list の識別子を添えてください。

資源の使用量を理解する

各モデルのライセンスと提供元の条件を確認してください:BGE-M3, Gemma 3, EmbeddingGemma, Gemma 4, Qwen 3.5, Qwen3 Embedding upstream。Qwenモデルは公式ページのライセンスやモデルカードへのリンクを確認します。同じOllama APIを使っていても、ライセンスは同じとは限りません。 ダウンロードサイズやパラメータ数はRAM・VRAM要件ではありません。量子化、コンテキスト、読み込んだモデル数でも使用量は変わります。CPU処理は遅くなる場合があり、長いコンテキストはメモリを多く使います。一定の端末仕様や速度は保証していません。 処理中に ollama ps でモデルとCPU・GPUの配置を確認できます。短い文章から試してください。負荷が大きい場合は小さいモデルを評価する、重い処理を閉じる、AIなしで通常の検索を使う、といった選択があります。

推論をローカルに保つ

端末にダウンロードするタグを使います。Ollamaにはクラウドモデルもあるため、ループバック接続だけではローカル推論の証明になりません。モデルとOllama設定を確認し、端末内で処理したい場合はクラウド版を選ばないでください。モデルには各処理に必要な文章が渡されます。拡張機能には別途権限の境界があります。

外部プロバイダーを使う

インテリジェンス → モデルではOpenAI、Anthropic、Gemini、OpenRouterの接続も追加できます。資格情報を保存して接続をテストし、対応する用途のプリセットを作成して機能に割り当てます。既存の会話は個別のモデル選択を保持します。 外部モデルには処理に必要な内容が送信されます。クリップをバックグラウンドで索引化するには、別途明示的な許可が必要です。埋め込み、画像、ツールの対応はプロバイダーとモデルによって異なります。 資格情報は端末の保護された領域に保存され、設定の書き出しには含まれません。macOSではキーチェーンの許可を求められる場合があります。接続を削除すると割り当てが解除され、自動で別モデルに切り替わることはありません。

復旧と無効化

  • 接続できない: Ollamaの起動と接続先を確認し、再接続前に ollama list を試します。
  • 対応モデルがない: 必要な能力のモデルをダウンロードし、一覧を更新して選びます。
  • 索引の失敗: インテリジェンスの索引画面で、対象クリップと診断を確認してから再試行します。
  • 生成の失敗や不適切な回答: モデル名を確認し、入力を短くするか別のモデルを評価します。同じAPIでも能力や結果は保証されません。
  • AIを停止: 機能への割り当てを解除するか、接続を無効にします。保存済み索引の削除は別の索引操作です。元のクリップは保持されます。
トラブルシューティングとプライバシーも確認してください。

判定モデル

ClipsX 0.1.8以降では、判定モデルが新しくコピーした文章への「はい/いいえ」の質問を評価します。一般的な判定は整理ルール、自動実行条件、許可された拡張機能からの要求に使います。プライバシー判定は資格情報の分類や保存を制限するルールに別途割り当てます。結果の文章を書くのは生成モデルです。 判定モデルを設定し、安全なタグ付けや条件付きRewriteを試してください。保存を制限する前にプライバシー操作と失敗時の動作を確認してください。ホスト型の提供元は評価対象の文章を受け取ります。プライバシーには端末内の推論を推奨します。