Repolode
microsoft

microsoft/prompty

Formato de archivo Markdown para prompts de LLM, con runtimes para Python, TypeScript, Rust, C# y otros lenguajes, además de una extensión de VS Code para ejecutarlos y rastrearlos.

Estrellas
1,286
Forks
135
Issues abiertos
23
Último commit
hace 4 días

¿Qué es?

Prompty es un formato de archivo y una clase de activos para prompts de LLM. Un archivo `.prompty` combina front matter en YAML, que contiene el modelo, la conexión, las entradas y las herramientas, con un cuerpo en Markdown que define mensajes de sistema, usuario y asistente mediante plantillas Jinja2 o Mustache. El objetivo es que los prompts sean portables y fáciles de inspeccionar, de modo que se pueda mover el mismo archivo entre aplicaciones y runtimes sin cambiar el texto del prompt.

El proyecto incluye runtimes para Python, TypeScript, Rust, C#, Java, Go y Swift, además de paquetes de proveedores para OpenAI, Microsoft Foundry y Anthropic. Una extensión de VS Code añade una barra lateral de conexiones, vista previa en vivo, modo de chat y un visor de trazas que registra los pasos de renderizado, análisis y llamadas al modelo. La versión 2 también incorpora un bucle de turnos agéntico que ejecuta las herramientas solicitadas por el modelo y devuelve una respuesta final.

Se puede configurar un endpoint compatible con OpenAI mediante la configuración de conexión, de modo que el mismo prompt pueda dirigirse a gateways o servidores de modelos autoalojados cambiando las variables de entorno.

Funciones clave

  • 01Define prompts como archivos `.prompty` con front matter en YAML y bloques de roles en Markdown.
  • 02Admite plantillas Jinja2 y Mustache, así como referencias a variables con `${env:VAR}`.
  • 03Ofrece runtimes para Python, TypeScript, Rust, C#, Java, Go y Swift.
  • 04Incluye paquetes de proveedores para OpenAI, Microsoft Foundry y Anthropic.
  • 05Extensión de VS Code con vista previa en vivo, modo de chat y visor de trazas.
  • 06Bucle de turnos agéntico que ejecuta las herramientas solicitadas por el modelo hasta obtener una respuesta final.

Casos de uso

  • Mantener prompts en el control de versiones como archivos legibles y separados del código de la aplicación.
  • Ejecutar el mismo prompt desde VS Code durante el desarrollo y desde un servicio de Python o TypeScript en producción.
  • Depurar el renderizado de prompts y las llamadas al modelo con archivos de trazas.
  • Enrutar prompts a través de un gateway compatible con OpenAI o un servidor de modelos autoalojado.

Inicio rápido

  1. 1

    Escribe un archivo .prompty con la configuración del modelo y el cuerpo del prompt en Markdown

  2. 2

    Instala el paquete de Python con compatibilidad con OpenAI

    uv pip install "prompty[jinja2,openai]"
  3. 3

    Ejecuta el prompt desde Python con prompty.invoke

  4. 4

    O instala los paquetes de TypeScript con compatibilidad con OpenAI

    npm install @prompty/core @prompty/openai

Antes de usarlo

  • Prompty v2 es más reciente y el README solicita comentarios al respecto.
  • Para ejecutar los ejemplos se necesita una clave de API de OpenAI u otro proveedor.

En colecciones

Temas

Preguntas frecuentes

¿Qué es prompty?
Formato de archivo Markdown para prompts de LLM, con runtimes para Python, TypeScript, Rust, C# y otros lenguajes, además de una extensión de VS Code para ejecutarlos y rastrearlos. Prompty es un formato de archivo y una clase de activos para prompts de LLM. Un archivo `.prompty` combina front matter en YAML, que contiene el modelo, la conexión, las entradas y las herramientas, con un cuerpo en Markdown que define mensajes de sistema, usuario y asistente mediante plantillas Jinja2 o Mustache. El objetivo es que los prompts sean portables y fáciles de inspeccionar, de modo que se pueda mover el mismo archivo entre aplicaciones y runtimes sin cambiar el texto del prompt.
¿prompty es gratuito? ¿Qué licencia tiene?
prompty es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿prompty sigue mantenido?
Mantenimiento activo. El último commit de prompty fue el 2 nov 2026.
¿Para qué puedo usar prompty?
Mantener prompts en el control de versiones como archivos legibles y separados del código de la aplicación. Ejecutar el mismo prompt desde VS Code durante el desarrollo y desde un servicio de Python o TypeScript en producción. Depurar el renderizado de prompts y las llamadas al modelo con archivos de trazas. Enrutar prompts a través de un gateway compatible con OpenAI o un servidor de modelos autoalojado.
¿Cómo se instala prompty?
Escribe un archivo .prompty con la configuración del modelo y el cuerpo del prompt en Markdown Instala el paquete de Python con compatibilidad con OpenAI: uv pip install "prompty[jinja2,openai]" Ejecuta el prompt desde Python con prompty.invoke O instala los paquetes de TypeScript con compatibilidad con OpenAI: npm install @prompty/core @prompty/openai
¿Dónde consigo prompty?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/microsoft/prompty

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

Proyectos relacionados