Repolode
knowsuchagency

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. 1

    Установите promptic из PyPI

    pip install promptic
  2. 2

    Задайте API-ключ провайдера LLM в качестве переменной среды (пример для OpenAI)

    export OPENAI_API_KEY=sk-...
  3. 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 структурированных данных, проверенных с помощью Pydantic, с поддержкой нескольких провайдеров и автоматическими повторами при ошибках валидации.

14,1 тыс.+18 за неделю1,4 тыс.PythonMITОбновлён 16 часов назад

Библиотека Python для создания генеративных программ, превращающих типизированные вызовы LLM в структурированные, тестируемые и самопроверяющиеся AI-процессы.

1,9 тыс.+6 за неделю177PythonApache-2.0Обновлён 16 часов назад