Ollamaの「Error: model not found, try pulling it first」エラーの解決方法

問題の概要新しい大規模言語モデル（LLM）をテストしようとした際、Ollamaから拒否されることがあります。コマンドを入力しても、ダウンロードバーが表示される代わりに、無愛想なエラーメッセージが表示されます。

Error: model not found, try pulling it first

これは通常、ollama run または ollama pull コマンドの実行中に発生します。モデルが公式ライブラリに存在する場合でも、ハイフンの位置が違ったり、バージョンタグが抜けていたりするだけでリクエストは失敗します。CLIは「モデルが存在しない」と言っているのではなく、「入力された文字列に一致するものが見つからない」と言っているのです。

デバッグ手順すべてを再インストールする前に、原因を特定するために以下の3つの一般的な要因を確認してください。

1. 正確なモデル名を確認するOllamaの命名規則は厳密です。よくある間違いは、レジストリに存在しない一般的な名前を使用したり、ハイフンを入れるべき場所にスペースを入れたりすることです。例えば、llama 3 は動作しませんが、llama3 なら動作します。

2. タグの欠落を確認するデフォルトでは、Ollamaは :latest タグを探します。モデルの作成者が特定のバージョン（:7b や :v1.5 など）のみをアップロードし、「latest」マニフェストをスキップした場合、プルは即座に失敗します。

3. レジストリへの接続テストローカルネットワークが registry.ollama.ai をブロックしている場合があります。ターミナルで curl を使用してAPIへの接続を確認できます。

curl -I https://registry.ollama.ai/v2/

エラーの解決策### 解決策1：公式ライブラリの名前を使用するモデル名を推測しないでください。Ollama Library にアクセスし、正確な文字列をコピーしてください。例えば、ユーザーは llama-3 をプルしようとしがちですが、公式レジストリ名は llama3 です。

誤り:

ollama pull llama-3

正しい例:

ollama pull llama3

解決策2：正しいタグを指定する特定のパラメータサイズが必要な場合は、コロンを付けて追加する必要があります。タグを省略し、メンテナが「latest」バージョンを指定していない場合、「not found」エラーが表示されます。これは特化型のモデルでよく見られます。

# これが失敗する場合: 
ollama pull deepseek-coder

# サイズを指定してみる（例：6.7Bパラメータ版）:
ollama pull deepseek-coder:6.7b

解決策3：Ollamaサーバーを更新する新しいモデルでは、そのマニフェスト形式を認識するために最新バージョンの Ollama エンジンが必要になることがよくあります。ここ数日以内にリリースされたモデルをプルしようとしている場合、ローカルのバイナリが古い可能性があります。最新のリリースを利用するには、少なくともバージョン 0.3.0 以降を実行していることを確認してください。

Linuxの場合:

curl -fsSL https://ollama.com/install.sh | sh

macOS/Windowsの場合: 公式サイトから最新のインストーラーをダウンロードし、現在のアプリケーションを上書きしてください。これには30秒ほどしかかかりません。

解決策4：プロキシと環境変数を修正する企業のファイアウォールが Ollama デーモンによるレジストリへのアクセスをブロックすることがよくあります。ブラウザが動作していても、バックグラウンドサービスがインターネットに接続できていない可能性があります。サービスに対して HTTPS_PROXY 変数を明示的に設定する必要があります。

systemdを使用しているLinuxの場合:

sudo systemctl edit ollama.service

ファイルに以下の行を追加します:

[Service]
Environment="HTTPS_PROXY=http://proxy.example.com:8080"

その後、設定をリロードしてサービスを再起動します:

sudo systemctl daemon-reload
sudo systemctl restart ollama

確認修正を確認するために、phi3:mini（約2.3GB）のような小さなモデルのプルを試行してください。マニフェストのダウンロードが開始されれば、問題は解決しています。

$ ollama pull llama3
マニフェストをプルしています 
6a383e581415をプルしています... 100% 

ダウンロードが完了したら、ローカルのインベントリを確認して準備ができているか確かめます:

ollama list

まとめ- まず検索する: コマンドを入力する前に、必ず公式ライブラリのページでモデルのスラッグ（識別子）を確認してください。- タグは必須: latest で失敗する場合は、:8b や :instruct などの特定のタグを探してください。- サービスとクライアントの違い: 実際のダウンロード処理は Ollama のバックグラウンドサービスが行います。そのサービスにネットワークアクセス権限がない場合、CLIはレジストリにアクセスして名前を確認できないため、「not found」エラーを報告します。