【2026年版】Ollama入門 — インストール・ローカルLLM・APIの使い方
- ローカルモデルの取得と対話
- モデルの管理
- PowerShell・PythonからのAPI利用
- 外部通信・メモリ・互換性の確認
ローカルモデルを試す前に
取得と、必要なメモリ
一覧・起動中モデル・API
互換性と外部連携
ローカルモデルで始める
2026年10月1日に公式資料を確認しました。この入門例はテキスト用の小さなモデル gemma3:1b を使用します。最新・最高性能のモデルを選ぶための記事ではなく、「モデルを取得して、対話とAPI呼び出しを試す」ことがゴールです。1Bはおおよそのパラメータ規模を示し、必要なRAM容量ではありません。
ローカルで動くことと、回答が正しいことは別です。事実や計算は元の資料で確認し、試しの入力には個人情報や機密情報を使わないでください。モデルの利用条件も、Ollama本体とは別に確認します。
OS別の導入と起動
| OS | 導入と最初の確認 |
|---|---|
| Windows | 公式Windows手順からインストーラーを導入。通常はバックグラウンドで起動します。インストール後に新しいPowerShellを開きます。 |
| macOS | 公式macOS手順に沿ってアプリをApplicationsへ入れ、起動します。CLIを使う場合はPATHの設定も確認します。 |
| Linux | 公式Linux手順で導入し、サービスまたは ollama serve でサーバーを起動します。GPUを使う場合は対応GPU・ドライバーも確認します。 |
OSの対応範囲と必要な空き容量は、各公式手順で確認してください。モデル保存用の容量は本体のインストール分とは別に必要です。
- Ollamaの公式QuickstartからOS別の導入手順を選びます。
- Ollamaアプリまたはサービスが起動していることを確認します。手動運用では
ollama serveを使いますが、これはそのターミナルで動き続けるコマンドです。起動済みなら重ねて実行しません。 - 次のコマンドでモデルを取得して対話します。初回は通信と空き容量が必要です。
ollama --version
ollama run gemma3:1b
対話に「日本語で短く自己紹介してください」と入力します。応答の内容は毎回同じではありません。終了は /bye です。
起動とモデル管理を確認する
まず ollama list が一覧を返すか確かめます。モデル名がまだなくても、サーバーへ接続できれば次のモデル取得へ進めます。APIでも次のように確認できます。
$models = Invoke-RestMethod -Uri 'http://127.0.0.1:11434/api/tags' -TimeoutSec 10
$models.models | Select-Object name, size, digest
size は保存されたモデルのバイト数で、実行時のメモリ消費量ではありません。digest は取得したモデルを識別する値です。空の一覧は「まだモデルを取得していない」状態で、接続エラーとは区別します。
使い始めたら、次のコマンドを使い分けます。
ollama list
ollama ps
ollama pull gemma3:1b
ollama stop gemma3:1b
ollama ps の PROCESSOR 列ではCPU・GPUへの配置を確認できます。CPUで動かせるモデルでも、応答速度は機器と入力の長さによって変わります。
不要になったモデルの削除は ollama rm gemma3:1b です。再利用時は取得し直す必要があります。
APIを試す(Windows PowerShell)
モデルを取得済みでOllamaが起動している状態で実行します。stream = $false にすると、分割された応答ではなく1つのJSONとして受け取れます。
$requestBody = @{
model = 'gemma3:1b'
prompt = '日本の首都を日本語で短く答えてください'
stream = $false
} | ConvertTo-Json
$result = Invoke-RestMethod -Uri 'http://127.0.0.1:11434/api/generate' -Method Post -ContentType 'application/json; charset=utf-8' -Body ([System.Text.Encoding]::UTF8.GetBytes($requestBody)) -TimeoutSec 180
if ($result.done -ne $true -or [string]::IsNullOrWhiteSpace($result.response)) {
throw '完了した空でない回答を確認できませんでした'
}
$result.response
APIを試す(Python 3・追加ライブラリ不要)
import json
from urllib.request import Request, urlopen
payload = json.dumps({
"model": "gemma3:1b",
"prompt": "日本の首都を日本語で短く答えてください",
"stream": False,
}).encode("utf-8")
request = Request(
"http://127.0.0.1:11434/api/generate",
data=payload,
headers={"Content-Type": "application/json"},
)
with urlopen(request, timeout=180) as response:
result = json.load(response)
if result.get("done") is not True or not result.get("response", "").strip():
raise RuntimeError("完了した空でない回答を確認できませんでした")
print(result["response"])
どちらも完了状態と空でない回答を確認してから、responseフィールドを表示します。完了したことと、首都の回答が事実として正しいことは別に確認します。この /api/generate の例では会話履歴を渡していないため、呼び出しごとに独立した入力です。複数ターンの履歴を扱う場合は、メッセージを送る /api/chat の仕様を確認します。
つまずいたときの切り分け
| 症状 | 確認すること |
|---|---|
ollama が見つからない | インストール完了後にターミナルを開き直す。PATHを含むOS別の公式手順を確認する。 |
| APIに接続できない | アプリ・サービスの起動と接続先を確認する。まず /api/tags で接続だけを試す。起動済みのサーバーへ ollama serve を重ねて起動しない。 |
| モデルが見つからない | ollama list の名前と要求の model を照合し、必要なら ollama pull gemma3:1b で取得する。 |
| 応答が遅い・タイムアウトする | 初回のモデル読み込み、ollama ps のCPU/GPU配置、空きメモリ、入力長を確認する。小さいモデル・短い入力で切り分ける。API例の180秒は待ち時間の上限で、処理完了の保証ではない。 |
| 11434番ポートが使用中と出る | すでにOllamaが起動しているかを確認する。アプリ・サービス・手動サーバーを重複して起動しない。 |
ローカル専用・費用・外部連携の注意
- 公式FAQの
disable_ollama_cloudまたはOLLAMA_NO_CLOUD=1をOllamaサーバーに設定し、再起動するとクラウドモデルとWeb検索を無効にできます。クライアント側のターミナルだけで設定しても、起動済みアプリには反映されません。 - ローカル推論の利用料と、電気代・機器代・モデルのライセンス・クラウドの契約は別です。「完全無料」と一括りにはできません。
- Open WebUIを追加する場合は、別製品の導入と設定が必要です。公式のDocker例ではコンテナ内のポートは8080で、ホスト側を3000にするなら
3000:8080と対応させます。永続ボリュームと、コンテナからOllamaへ届く接続先も確認してください。コンテナ内のlocalhostは、ホストPCのlocalhostと同じではありません。 - 初期設定のローカルAPIを、不用意にインターネットへ公開しないでください。
このページのAPI例は公式仕様に照らして記載しています。モデルや機器による応答速度・回答精度を保証するものではありません。
参考資料
確認日:2026年10月1日。機能・利用条件は更新されるため、利用時は各公式ページも確認してください。
- Ollama Quickstart — 導入・実行
- Ollama CLI Reference — モデルの取得・一覧・停止
- Ollama FAQ — ローカル/クラウド・無効化・メモリ・bind
- Gemma 3 1Bのモデル情報 — 明示的なモデルタグ
- Ollama Generate API — 要求形式とstream
- Ollama List models API — 接続確認・size・digest
- Ollama Chat API — 会話履歴のメッセージ
- Ollama Windows・macOS・Linux — OS別の導入・起動
- Ollama OpenAI互換性 — 互換範囲
- Ollama Embed API — 埋め込みAPIの存在
- Open WebUI Quick Start — Docker内部ポート・永続化・接続先