AI が読み込まれない
AI サービスはエージェントとは別のプロセスで、失敗の仕方も独自です。この一覧を上から確かめて ください。並び順は、それぞれが実際に答えだった頻度を映しています。
1. AI サービスは本当に動いていますか
エージェントと AI サービスは別物です。エージェントがオンラインでファイルを提供していても、AI サービスは一度も起動していない、ということがあり得ます。
設定ツールの AI Hub か、ブラウザーの AI 画面から起動してください。状態は「停止」「起動中」 「重みを読み込み中」「オンライン」のどれかを示します——重みの読み込みは固まっているのではなく、 仕事をしているところです。
AiAutoStart はサービスをエージェントと一緒に立ち上げるかを決める設定で、既定はオフです。
2. モデルは入手済みですか
選んだモデルと入手したモデルは違います。パネルは「Model not downloaded」とはっきり出し、 直し方はボタン 1 つです。
ダウンロードは数ギガバイトあり、ブラウザーではなくデバイスへ入ります。取り消したり中断したりした ダウンロードは使えるものを残しません。もう一度始めてください。
3. メモリーは足りていますか
実際にいちばん多い失敗で、設定ツールは事前に警告します——「モデルに約 7 GB 必要、空きは 4 GB」。
目安:
- 10〜20 億パラメーターのモデルには空きが 2 ギガバイトほど要ります。
- 70〜80 億なら 8 ギガバイト以上。
- 専門モデルを読み込むと、読み込んでいるあいだそのぶん上乗せされます。
メモリーが足りなくなるとマシンはスワップを始め、症状はきれいなエラーではありません。サービスが 応答しなくなり、状態確認はタイムアウトし、ディスクが唸るあいだ AI は「切れている」ように見えます。 それが見えているなら、待つのではなく小さいモデルを選んでください。
メモリーが 8 GB 未満の Raspberry Pi では --no-ai で入れ、そこでモデルを動かさないでください。
4. Python の依存関係は入っていますか
AI の初回起動が進捗ウィンドウ付きで入れます。その段階が失敗していれば——ネットワークがない、 ディスクが足りない、Python がない——サービスは立ち上がれません。
- Windows・インストール版 —— 専用の Python が付いてくるので、これはまれです。
- Windows・ポータブル版 —— Python は自分で入れ、
setup_ai.batを実行します。 ポータブル版:インストールせずに Windows で Filemote を動かす を参照。 - Linux/macOS ——
--no-aiを渡していなければ、インストールスクリプトが面倒を見ます。
AI Hub では、ウィザードの Environment の段階でこの確認をいつでもやり直せます。
5. ポート 8765 を誰かが取っていませんか
AI サービスはそのマシンのポート 8765 で待ち受けます。別のプログラムがそのポートを握っていると、 サービスはバインドできず起動時に失敗します。
関連して、しばらくのあいだ不具合に見えていたので触れておきます。設定ツールとエージェントは同じ AI サービスを両方が持ち得ます。かつて Stop がウィンドウの持つハンドルだけを閉じる版があり、反対側 が起動したサービスは生き延び、状態のポーリングがそれを連れ戻していました——AI が自分で起動している ように見えたのです。いまは直っています。詳しくは AI Hub を参照して ください。
6. そもそもチャット用のモデルですか
モデル置き場にあるものがすべて会話できるわけではありません。設定ツールは読み込む前に検証し、
「見つからない」あるいは「チャットに向かない」とはっきり告げます。利用申請が要るモデルには
Hugging Face のトークンも必要で、インストールスクリプトは --hf-token で受け取ります。
意味のはっきりしている症状
| 見えているもの | たいていの意味 |
|---|---|
| チャットがエージェント未読み込みと言う | サービスは動作中、モデルが読み込まれていない |
| 最初の返答だけ非常に遅い | 正常:重みをメモリーへ読み込み中 |
| 返答が空 | 返信の長さの上限に達した——AiMaxNewTokens |
| 状態がタイムアウトし、マシンが重い | スワップ:このマシンにはモデルが大きすぎる |
| ナレッジベースに件数は出るが操作できない | サービス停止中。数字はディスク由来 |
どれでもないとき
AI サービスはエージェントとは別に自分のログを持ちます——ログを読むを 参照してください。AI Hub も起動時のエラーをその場で見せるので、たいていファイルを読むより速い です。
2026-08-06 に更新