OllamaのModelfileで設定を再利用する入門

先に結論

OllamaのModelfileは、ベースモデルとsystem指示、生成parameterを一つの定義書にまとめるファイルです。定義を保存してollama createで名前を付ければ、毎回同じ設定を手入力せずに呼び戻せます。ただし、同じタグが将来同じモデルを指す保証まではこのファイルだけで作れないため、作成時点のモデル情報も一緒に記録します。

確認日時: 2026年8月18日（Asia/Tokyo）
対象仕様: Ollama公式Modelfile Reference、Create API、Show model detailsの現行記載。
検証区分: 公式ドキュメントを読んだ机上確認です。この制作環境ではOllama daemon、モデル取得、生成、作成済みモデルの実行を行っていません。
未確認: Ollamaの具体的なインストール版、モデルのlicense、利用機種ごとのmemoryと速度は環境ごとに異なります。

Modelfileで固定するもの

Modelfileは、Ollamaでカスタムモデルを作成・共有するための設計図です。公式リファレンスでは、FROMが必須でベースモデルを指定し、PARAMETERが実行時の設定、TEMPLATEがモデルへ渡す完全なprompt形式、SYSTEMがsystem messageを担当します。ほかにもadapter、license、message履歴、必要なOllama最小版を示すREQUIRESがあります。

まずは、変更点を増やしすぎない小さな定義にします。temperatureは出力のランダムさ、num_ctxは生成時に参照するcontext windowの大きさ、seedは同じpromptに対する再現性を助ける値です。seedを指定しても、model本体、template、Ollamaの版、実行条件が変われば同じ出力になるとは限りません。

最短手順：定義を作って実行する

最初は、すでに利用できる小さなモデル名を一つ選びます。モデルの取得方法やlicenseはモデルごとに確認してください。以下は公式リファレンスの形式に沿った最小例で、モデル名は手元で利用可能なものへ置き換えます。

# 例: Modelfile
FROM llama3.2
SYSTEM """簡潔で検証可能な日本語で答えてください。"""
PARAMETER temperature 0.2
PARAMETER num_ctx 4096
PARAMETER seed 42

ファイルを保存したら、定義からローカル名を作ります。

ollama create kfb-modelfile-demo -f ./Modelfile
ollama run kfb-modelfile-demo "Modelfileの役割を一文で説明してください"
ollama show --modelfile kfb-modelfile-demo

ollama createが成功し、ollama runが応答を返せば、最初の成功です。最後のollama show --modelfileは、作成済みモデルからModelfile相当の定義を表示します。公式例では、表示された定義を再利用する際にFROMをモデル名やタグへ置き換える流れも示されています。

成功を確認するチェック項目

1. FROMのモデルが意図したものかを確認します。タグ名だけでなく、取得日時、Ollamaの版、ollama showで見えるformat・family・quantization levelをメモします。
2. SYSTEMが応答の役割に反映されているかを、秘密情報を含まない短い固定promptで確認します。
3. PARAMETERを一度に一つだけ変え、同じpromptで比較します。速度や品質を測定していないなら、改善したとは書かず「設定が変わった」とだけ記録します。
4. ollama show --modelfileの出力を保存し、元のModelfileとの差分を見ます。実行時の一時設定と、定義書に書いた設定を混同しないことが重要です。

つまずきやすい点と戻し方

ollama createでFROMを解決できない

モデル名の綴り、ローカルに取得済みか、Ollama daemonが起動しているかを順に確認します。まず元の定義ファイルを残したまま、FROMだけを実際に利用できるモデル名へ直します。作成済みの別名を削除してやり直す場合も、元のModelfileと検証メモを先に保存します。

templateを自分で書き換えて応答が崩れた

TEMPLATEの構文と変数はモデル固有です。公式リファレンスでも、{{ .System }}、{{ .Prompt }}、{{ .Response }}を使う例を示しつつ、syntaxはmodel specificと説明しています。まずollama show --modelfileで元のtemplateを確認し、templateを変更せずにSYSTEMとPARAMETERだけで目的を満たせるかを試します。

adapterを足したら結果が不安定になった

公式リファレンスは、ADAPTERのbase modelが学習時のbaseと同じでない場合、挙動が不安定になると警告しています。baseの一致を確認できないadapterは使わず、直前のModelfileへ戻します。adapterを使わない定義が動くことを先に確認しておくと、原因を分離できます。

次に進む前の判断

Modelfileは設定を配布・再利用する入口ですが、タグを固定しただけで完全な再現性が得られるわけではありません。ベースモデルの識別情報、Modelfile本文、Ollamaの版、実行機種、固定prompt、出力、確認日時を同じフォルダーへ保存して初めて、後から差分を追いやすくなります。template、stop、seed、context長を比較する設計は、同日の玄人向け記事で詳しく整理しています。

参考資料

• Ollama Modelfile Reference（FROM、PARAMETER、TEMPLATE、SYSTEM、ADAPTER、REQUIRESを2026年8月18日に確認）
• Ollama Create API（from、system、parameters、messages、quantizeの入力項目を同日に確認）
• Ollama Show model details API（model情報、format、family、quantization levelの表示例を同日に確認）