Библиотека Python для получения от LLM структурированных данных, проверенных с помощью Pydantic, с поддержкой нескольких провайдеров и автоматическими повторами при ошибках валидации.
knowsuchagency/promptic
Лёгкая библиотека декораторов для Python: превращает docstring в промпты для LLM и поддерживает Pydantic, вызов инструментов, стриминг и память на базе LiteLLM.
- Звёзды
- 272
- Форки
- 24
- Открытые issues
- 0
- Последний коммит
- 26 дней назад
Что это?
Promptic — небольшая библиотека Python для создания приложений на базе LLM. Вы добавляете к функции декоратор @llm, а её docstring становится шаблоном промпта, который заполняется аргументами функции. Вызов возвращает ответ модели напрямую, поэтому функция может выступать в роли промпта без ручной обработки запросов.
Внутри используется LiteLLM, поэтому один и тот же код можно направлять в OpenAI, Anthropic, Gemini, Azure и другие сервисы, меняя название модели. В аннотациях типа возвращаемого значения можно указать модели Pydantic или словари JSON Schema — ответы будут проверяться на соответствие им. Функции с декоратором @llm.tool предоставляются модели как вызываемые инструменты.
Библиотека также поддерживает изображения через тип ImageBytes, стриминг ответов, опциональную память диалога с подключаемым классом State, настройки кеширования промптов Anthropic и интеграцию с трассировкой Weave. Библиотека намеренно остаётся тонким слоем, чтобы базовые SDK провайдеров оставались доступными.
Ключевые возможности
- 01Превращает docstring функций в шаблоны промптов с помощью декоратора @llm.
- 02Проверяет структурированные выходные данные по моделям Pydantic или JSON Schema.
- 03Поддерживает вызов инструментов — функций, зарегистрированных через @llm.tool.
- 04Стримит ответы и принимает изображения в виде ImageBytes.
- 05Предоставляет опциональную память диалога с настраиваемым классом State.
Сценарии использования
- Создание прототипов функций на базе LLM в Python без шаблонного кода для запросов.
- Извлечение типизированных данных из текста или изображений в объекты Pydantic.
- Создание простого чат-бота или агента, который вызывает функции Python как инструменты.
- Переключение между провайдерами LLM без переписывания кода приложения.
Быстрый старт
- 1
Установите promptic из PyPI
pip install promptic - 2
Задайте API-ключ провайдера LLM в качестве переменной среды (пример для OpenAI)
export OPENAI_API_KEY=sk-... - 3
Добавьте к функции декоратор @llm, используйте её docstring как промпт и вызовите её
Что важно знать
- Требуется API-ключ провайдера LLM (например, OpenAI или Anthropic) либо совместимая конфигурация модели.
В подборках
Темы
Частые вопросы
- Что такое promptic?
- Лёгкая библиотека декораторов для Python: превращает docstring в промпты для LLM и поддерживает Pydantic, вызов инструментов, стриминг и память на базе LiteLLM. Promptic — небольшая библиотека Python для создания приложений на базе LLM. Вы добавляете к функции декоратор @llm, а её docstring становится шаблоном промпта, который заполняется аргументами функции. Вызов возвращает ответ модели напрямую, поэтому функция может выступать в роли промпта без ручной обработки запросов.
- promptic можно использовать бесплатно? Какая у него лицензия?
- promptic распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- promptic всё ещё поддерживается?
- Активно поддерживается. Последний коммит в promptic — 12 окт. 2026 г..
- Для чего можно использовать promptic?
- Создание прототипов функций на базе LLM в Python без шаблонного кода для запросов. Извлечение типизированных данных из текста или изображений в объекты Pydantic. Создание простого чат-бота или агента, который вызывает функции Python как инструменты. Переключение между провайдерами LLM без переписывания кода приложения.
- Как установить promptic?
- Установите promptic из PyPI: pip install promptic Задайте API-ключ провайдера LLM в качестве переменной среды (пример для OpenAI): export OPENAI_API_KEY=sk-... Добавьте к функции декоратор @llm, используйте её docstring как промпт и вызовите её
- Где скачать promptic?
- Исходный код и инструкции по установке — на GitHub: https://github.com/knowsuchagency/promptic
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Библиотека Python для создания генеративных программ, превращающих типизированные вызовы LLM в структурированные, тестируемые и самопроверяющиеся AI-процессы.
Официальный SDK для Java и Kotlin для OpenAI REST API: синхронные и асинхронные клиенты, потоковая передача и типизированные классы запросов и ответов.
Набор agent skills с актуальным контекстом для AI-ассистентов, которые разрабатывают приложения с Gemini API и SDK.
Опишите интерфейс обычными словами, сразу увидьте результат и дорабатывайте его с помощью любой поддерживаемой LLM.
Голосовой ассистент для Raspberry Pi с самостоятельным размещением: LiteLLM и LangGraph добавляют общение в стиле ChatGPT в систему умного дома.