Repolode
Enviar
knowsuchagency

knowsuchagency/promptic

Una biblioteca ligera de decoradores para Python que convierte docstrings en prompts para LLM, con salidas Pydantic, llamadas a herramientas, streaming y memoria, basada en LiteLLM.

Ver en GitHubSitio web
Estrellas
272
Forks
24
Issues abiertos
0
Último commit
hace 26 días

¿Qué es?

Promptic es una pequeña biblioteca de Python para crear aplicaciones con LLM. Se añade el decorador @llm a una función y su docstring se convierte en una plantilla de prompt que se completa con los argumentos de la función. La llamada devuelve directamente la respuesta del modelo, así que una función puede servir como prompt sin tener que gestionar las solicitudes manualmente.

Internamente, usa LiteLLM, por lo que el mismo código puede dirigirse a OpenAI, Anthropic, Gemini, Azure y otros proveedores con solo cambiar el nombre del modelo. Las anotaciones de tipo de retorno pueden ser modelos de Pydantic o diccionarios JSON Schema, y las respuestas se validan con ellos. Las funciones decoradas con @llm.tool se exponen al modelo como herramientas invocables.

La biblioteca también admite entradas de imagen mediante el tipo ImageBytes, respuestas en streaming, memoria de conversación opcional con una clase State intercambiable, controles de caché de prompts de Anthropic e integración de trazas con Weave. Está diseñada para ser ligera y mantener accesibles los SDK de los proveedores subyacentes.

Funciones clave

  • 01Convierte los docstrings de las funciones en plantillas de prompt mediante el decorador @llm.
  • 02Valida las salidas estructuradas con modelos de Pydantic o JSON Schema.
  • 03Admite llamadas a herramientas con funciones registradas mediante @llm.tool.
  • 04Ofrece respuestas en streaming y acepta imágenes como entradas de tipo ImageBytes.
  • 05Incluye memoria de conversación opcional con una clase State personalizable.

Casos de uso

  • Crear prototipos de funcionalidades con LLM en Python sin escribir código repetitivo para las solicitudes.
  • Extraer datos tipados de texto o imágenes y convertirlos en objetos Pydantic.
  • Crear un chatbot o agente sencillo que invoque funciones de Python como herramientas.
  • Cambiar de proveedor de LLM sin reescribir el código de la aplicación.

Inicio rápido

  1. 1

    Instala promptic desde PyPI

    pip install promptic
  2. 2

    Configura la clave de API de tu proveedor de LLM como variable de entorno (ejemplo para OpenAI)

    export OPENAI_API_KEY=sk-...
  3. 3

    Decora una función con @llm, usando su docstring como prompt, y llámala

Antes de usarlo

  • Se necesita una clave de API de un proveedor de LLM (como OpenAI o Anthropic) o una configuración de modelo compatible.

En colecciones

Herramientas de streaming

Temas

#llm#python#structured-outputs#function-calling#streaming#litellm#pydantic#ai#llms#utility

Preguntas frecuentes

¿Qué es promptic?
Una biblioteca ligera de decoradores para Python que convierte docstrings en prompts para LLM, con salidas Pydantic, llamadas a herramientas, streaming y memoria, basada en LiteLLM. Promptic es una pequeña biblioteca de Python para crear aplicaciones con LLM. Se añade el decorador @llm a una función y su docstring se convierte en una plantilla de prompt que se completa con los argumentos de la función. La llamada devuelve directamente la respuesta del modelo, así que una función puede servir como prompt sin tener que gestionar las solicitudes manualmente.
¿promptic es gratuito? ¿Qué licencia tiene?
promptic es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿promptic sigue mantenido?
Mantenimiento activo. El último commit de promptic fue el 12 oct 2026.
¿Para qué puedo usar promptic?
Crear prototipos de funcionalidades con LLM en Python sin escribir código repetitivo para las solicitudes. Extraer datos tipados de texto o imágenes y convertirlos en objetos Pydantic. Crear un chatbot o agente sencillo que invoque funciones de Python como herramientas. Cambiar de proveedor de LLM sin reescribir el código de la aplicación.
¿Cómo se instala promptic?
Instala promptic desde PyPI: pip install promptic Configura la clave de API de tu proveedor de LLM como variable de entorno (ejemplo para OpenAI): export OPENAI_API_KEY=sk-... Decora una función con @llm, usando su docstring como prompt, y llámala
¿Dónde consigo promptic?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/knowsuchagency/promptic

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados