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
PyPIからprompticをインストールします
pip install promptic - 2
LLMプロバイダーのAPIキーを環境変数に設定します(OpenAIの場合の例)
export OPENAI_API_KEY=sk-... - 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 の数値は毎日更新されます。
関連プロジェクト
型付きLLM呼び出しを、構造化・テスト可能・自己検証型のAIワークフローに変える生成プログラムを記述するPythonライブラリ。
OpenAI REST API向けの公式Java・Kotlin SDK。同期・非同期クライアント、ストリーミング、型付きリクエスト/レスポンスクラスを提供します。
Gemini APIとSDKを使ったアプリ開発に必要な最新情報をAIコーディングアシスタントに提供する、エージェントスキル集です。
UIを自然な言葉で説明してライブ表示し、対応するLLMで繰り返し改善できます。
LiteLLMとLangGraphを使い、Raspberry PiのスマートホームにChatGPT風の会話機能を追加できるセルフホスト型音声アシスタントです。