Repolode
ollama

ollama/ollama-python

Ollamaのローカルモデルやクラウドモデルを、チャット、生成、埋め込み、モデル管理API経由で呼び出す公式Pythonクライアントライブラリ。

スター
10,611
フォーク
1,209
未解決の Issue
223
最終コミット
4 日前

これは何?

Ollama PythonライブラリはOllama REST API用のクライアントで、Python 3.8以降のプロジェクトから、起動中のOllamaインスタンスが提供するモデルを利用できます。chat、generate、embed、list、pull、push、copy、delete、プロセス状態の確認を少数の関数で利用でき、同期・非同期の両方に対応しています。

レスポンスは一括でもチャンク単位のストリーミングでも取得できます。同じクライアントでローカルのOllamaサーバーにも、API keyを使ってollama.comのホスト型クラウドAPIにも接続できます。gpt-oss:120b-cloudなどのクラウドモデルは、サインイン後にローカルサーバー経由で実行することも、直接呼び出すこともできます。HTTPステータスが成功以外の場合やストリーミング中に発生したエラーは、ResponseErrorとして送出されます。

さらに、複数の選択肢から1つを選ぶ、尺度で評価する、はい/いいえの確率を返すといった構造化された判断を行うSystem One APIも含まれています。nimbleやclefなどの判断モデルを利用できます。

主な機能

  • 01Ollama REST APIに対応したchat、generate、embedの呼び出し。
  • 02同期・非同期の両方で、stream=Trueによるストリーミングレスポンスに対応。
  • 03カスタムhostとhttpxのheadersを指定できるClientクラスとAsyncClientクラス。
  • 04list、show、create、pull、push、copy、deleteを行うモデル管理関数。
  • 05ローカルサーバー経由、またはAPI keyを使ってollama.comに直接接続してクラウドモデルを利用可能。
  • 06選択、はい/いいえ、スコア形式の質問に対応するSystem Oneの構造化判断API。

ユースケース

  • PythonのWebアプリやスクリプトに、ローカルLLMのチャット機能を追加する。
  • 検索や検索拡張パイプライン向けのテキスト埋め込みを生成する。
  • 同じコードのまま、ローカルモデルとホスト型クラウドモデルを切り替える。
  • 構造化された判断用の質問を使って、自動トリアージや分類の処理を構築する。

クイックスタート

  1. 1

    Ollamaをインストールし、実行中であることを確認します

  2. 2

    ライブラリで使用するモデルをpullします

    ollama pull gemma4
  3. 3

    Pythonライブラリをインストールします

    pip install ollama
  4. 4

    PythonからチャットAPIを呼び出します

使う前に知っておきたいこと

  • ローカルにインストールして実行中のOllamaサーバー、またはクラウドモデル用のOllama APIキーが必要です。
  • クラウドモデルを利用するにはOllamaアカウントが必要です。また、クラウドAPIへのアクセスには有料プランが必要な場合があります。

トピック

よくある質問

ollama-python とは?
Ollamaのローカルモデルやクラウドモデルを、チャット、生成、埋め込み、モデル管理API経由で呼び出す公式Pythonクライアントライブラリ。 Ollama PythonライブラリはOllama REST API用のクライアントで、Python 3.8以降のプロジェクトから、起動中のOllamaインスタンスが提供するモデルを利用できます。chat、generate、embed、list、pull、push、copy、delete、プロセス状態の確認を少数の関数で利用でき、同期・非同期の両方に対応しています。
ollama-python は無料で使えますか?ライセンスは?
ollama-python は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
ollama-python は今もメンテナンスされていますか?
活発にメンテナンス中。ollama-python の最終コミットは 2026年10月16日 です。
ollama-python は何に使えますか?
PythonのWebアプリやスクリプトに、ローカルLLMのチャット機能を追加する。 検索や検索拡張パイプライン向けのテキスト埋め込みを生成する。 同じコードのまま、ローカルモデルとホスト型クラウドモデルを切り替える。 構造化された判断用の質問を使って、自動トリアージや分類の処理を構築する。
ollama-python のインストール方法は?
Ollamaをインストールし、実行中であることを確認します ライブラリで使用するモデルをpullします: ollama pull gemma4 Pythonライブラリをインストールします: pip install ollama PythonからチャットAPIを呼び出します
ollama-python はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/ollama/ollama-python

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト