Repolode
knowsuchagency

knowsuchagency/promptic

docstringをLLMプロンプトに変換し、Pydantic出力、ツール呼び出し、ストリーミング、メモリを利用できるLiteLLMベースの軽量なPythonデコレーターライブラリ。

スター
272
フォーク
24
未解決の Issue
0
最終コミット
26 日前

これは何?

Prompticは、LLMアプリケーションを構築するための小さなPythonライブラリです。関数に@llmを付けると、そのdocstringがプロンプトテンプレートになり、関数の引数が埋め込まれます。呼び出すとモデルの応答がそのまま返されるため、リクエスト処理を手動で書かずに関数をプロンプトとして使えます。

内部ではLiteLLMを使用しているため、モデル名を変えるだけで、同じコードからOpenAI、Anthropic、Gemini、Azureなどのプロバイダーを利用できます。戻り値の型注釈にはPydanticモデルやJSON Schema辞書を指定でき、応答はそれらに照らして検証されます。@llm.toolを付けた関数は、モデルから呼び出せるツールとして公開されます。

このライブラリは、ImageBytes型による画像入力、ストリーミング応答、Stateクラスを差し替えて使える任意の会話メモリ、Anthropicのプロンプトキャッシュ制御、Weaveのトレース連携にも対応しています。薄いラッパーにとどめる設計のため、基盤となるプロバイダーのSDKも引き続き利用できます。

主な機能

  • 01@llmデコレーターを使い、関数のdocstringをプロンプトテンプレートに変換します。
  • 02構造化出力をPydanticモデルまたはJSON Schemaに照らして検証します。
  • 03@llm.toolで登録した関数によるツール呼び出しに対応します。
  • 04応答をストリーミングでき、ImageBytes型で画像入力を受け付けます。
  • 05カスタマイズ可能なStateクラスを使った任意の会話メモリを利用できます。

ユースケース

  • リクエスト処理の定型コードを書かずに、PythonでLLM機能を試作する。
  • テキストや画像から型付きデータを抽出し、Pydanticオブジェクトに変換する。
  • Python関数をツールとして呼び出すシンプルなチャットボットやエージェントを構築する。
  • アプリケーションコードを書き換えずに、LLMプロバイダーを切り替える。

クイックスタート

  1. 1

    PyPIからprompticをインストールします

    pip install promptic
  2. 2

    LLMプロバイダーのAPIキーを環境変数に設定します(OpenAIの場合の例)

    export OPENAI_API_KEY=sk-...
  3. 3

    関数に@llmデコレーターを付け、docstringをプロンプトとして使って呼び出します

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

  • OpenAIやAnthropicなどのLLMプロバイダーのAPIキー、または互換性のあるモデル環境が必要です。

収録されている特集

トピック

よくある質問

promptic とは?
docstringをLLMプロンプトに変換し、Pydantic出力、ツール呼び出し、ストリーミング、メモリを利用できるLiteLLMベースの軽量なPythonデコレーターライブラリ。 Prompticは、LLMアプリケーションを構築するための小さなPythonライブラリです。関数に@llmを付けると、そのdocstringがプロンプトテンプレートになり、関数の引数が埋め込まれます。呼び出すとモデルの応答がそのまま返されるため、リクエスト処理を手動で書かずに関数をプロンプトとして使えます。
promptic は無料で使えますか?ライセンスは?
promptic は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
promptic は今もメンテナンスされていますか?
活発にメンテナンス中。promptic の最終コミットは 2026年10月12日 です。
promptic は何に使えますか?
リクエスト処理の定型コードを書かずに、PythonでLLM機能を試作する。 テキストや画像から型付きデータを抽出し、Pydanticオブジェクトに変換する。 Python関数をツールとして呼び出すシンプルなチャットボットやエージェントを構築する。 アプリケーションコードを書き換えずに、LLMプロバイダーを切り替える。
promptic のインストール方法は?
PyPIからprompticをインストールします: pip install promptic LLMプロバイダーのAPIキーを環境変数に設定します(OpenAIの場合の例): export OPENAI_API_KEY=sk-... 関数に@llmデコレーターを付け、docstringをプロンプトとして使って呼び出します
promptic はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/knowsuchagency/promptic

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

関連プロジェクト