同期・非同期クライアントと型付きのリクエスト/レスポンスモデルを備えた、OpenAI REST API公式Pythonライブラリ。
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
Ollamaをインストールし、実行中であることを確認します
- 2
ライブラリで使用するモデルをpullします
ollama pull gemma4 - 3
Pythonライブラリをインストールします
pip install ollama - 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 の数値は毎日更新されます。
関連プロジェクト
リモートおよびローカルにインストールした大規模言語モデルにプロンプトやチャットを実行できる、CLIツール兼Pythonライブラリ。
LLMとグラフベースのパイプラインを使い、プロンプトに基づいてWebサイトやローカル文書から構造化データを抽出するPythonライブラリ。
LangGraphを使った、階層型インデックスや会話メモリ、質問の明確化に対応するモジュール式Agentic RAGチュートリアル。
Ollamaを使ってローカルモデルに段階的に推論させ、その過程をRDFグラフとして自分のマシンに保存するナレッジグラフツール。
RAG、ベクトル検索、エージェント、評価、監視を使ったLLMアプリケーション構築を学ぶ、無料のオープンソース10週間オンラインコース。