prompty
Prompty is a markdown-based format and toolkit for writing, managing, and executing LLM prompts across Python, TypeScript, and VS Code. It abstracts away provider-specific syntax, letting developers write once and run against OpenAI, Azure Foundry, Anthropic, or OpenAI-compatible endpoints.
Key facts
Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.
| Field | Value |
|---|---|
| Repository | microsoft/prompty |
| Owner | microsoft |
| Primary language | TypeScript |
| License | MIT — OSI-approved |
| Stars | 1.2k |
| Forks | 118 |
| Open issues | 13 |
| Latest release | csharp/0.2.3-beta (2025-07-24) |
| Last updated | 2026-07-01 |
| Source | https://github.com/microsoft/prompty |
What prompty is
A `.prompty` file format combining YAML frontmatter (model config, inputs, tools) with markdown body (Jinja2 or Mustache templating and role markers). Runtimes (Python and TypeScript) load, render, parse, and execute prompts via pluggable providers; VS Code extension adds debugging, tracing, and connections management.
Get the prompty source
Clone the repository and explore it locally.
git clone https://github.com/microsoft/prompty.gitcd prompty# follow the project's README for install & configurationNeed it deployed, integrated, or customized instead? DEV.co ships production installs.
Best use cases
Implementation considerations
- v2 is currently in alpha; API, file format, and tooling are under active development. Production use requires acceptance of potential breaking changes and a process to track upstream updates.
- Credentials are passed via environment variables or runtime load options; ensure secure injection in CI/CD and container deployments. `${file:...}` references are scoped to the prompt directory; host applications can expand scope, but this must be explicitly permitted.
- Prompts are rendered and parsed before execution; understand the Jinja2/Mustache template evaluation order and how variable interpolation interacts with model parameters and tool definitions.
- Install provider-specific extras (e.g., `pip install 'prompty[jinja2,openai]'`) to enable only the LLM APIs your application needs; this reduces dependency surface.
- Async support is available in both Python and TypeScript runtimes; for high-concurrency workloads, use async variants to avoid blocking.
When to avoid it — and what to weigh
- Complex Multi-Turn Stateful Conversations — Prompty is designed for single-turn or thread-enabled prompts. If your use case requires deep conversation state management, context windowing, or memory persistence beyond what the format natively supports, consider a fuller agent framework.
- Production Deployment Without Additional Infrastructure — Prompty is a format and development toolkit; it does not provide built-in observability, rate limiting, caching, or failover. Deploying to production requires wrapping it in a service layer or orchestrator.
- Vendor Lock-In to a Specific LLM Provider — If your architecture depends on proprietary features (e.g., Azure Foundry's specific tool calling semantics), portability is limited. Prompty normalizes common patterns but may not abstract provider-specific nuances.
- Non-Markdown Prompt Syntax or Domain-Specific Languages — If your team uses structured prompt frameworks (e.g., JSON-based instruction sets, DSLs), the markdown format may feel constraining. Adopting Prompty requires a culture shift toward markdown-first prompt authoring.
License & commercial use
MIT License. Permissive OSI license; allows commercial use, modification, and distribution with attribution and no warranty.
MIT license permits commercial use. No paid support model documented in the provided data. Verify support SLAs, enterprise licensing, or Azure integration terms with Microsoft if required for production deployments.
DEV.co evaluation signals
Editorial assessment — not user reviews. Directional, with an explicit confidence level.
| Signal | Assessment |
|---|---|
| Maintenance | Active |
| Documentation | Adequate |
| License clarity | Clear |
| Deployment complexity | Low |
| DEV.co fit | Good |
| Assessment confidence | High |
Prompts stored in `.prompty` files may contain sensitive instructions or examples; store them in secure repositories and control access. Credentials are injected via environment variables—use standard secrets management (e.g., vaults, CI/CD secrets). `${file:...}` reads are scoped to the prompt directory by default but can be expanded by the host application; audit any expanded scope. No claims about input validation, injection prevention, or model output filtering are stated; implement these in the application layer.
Alternatives to consider
LangChain
Larger agent framework with built-in memory, retrieval, and multi-turn orchestration. Heavier than Prompty but offers more production-ready features (caching, callbacks, observability plugins).
LlamaIndex (formerly GPT Index)
Focused on indexing, retrieval, and RAG pipelines. Better suited if your primary need is semantic search and context augmentation rather than prompt format portability.
Anthropic's Prompt Caching & Native Tooling
Anthropic provides prompt caching and tool definitions natively in their SDK. If you are exclusively on Anthropic, their native approach may offer tighter integration without the multi-provider abstraction overhead.
Build on prompty with DEV.co software developers
Evaluate Prompty's file format, runtimes, and VS Code integration against your team's prompt development and deployment needs. Review the alpha roadmap and version stability expectations before committing to production use.
Talk to DEV.coRelated open-source tools
Surfaced by semantic similarity across the DEV.co open-source index.
Related on DEV.co
Explore the category and the services that help you build with it.
prompty FAQ
Can I use Prompty in production today?
Does Prompty handle prompt versioning or experiment tracking?
Can I deploy Prompty files to a serverless function?
What happens if an LLM provider endpoint changes or is unavailable?
Software developers & web developers for hire
DEV.co helps companies turn open-source tools like prompty into production software. Our software development services cover the full lifecycle — architecture, web development, integration, and maintenance — delivered by software developers and web developers who ship. Engage our software development agency to implement or customize it for your ai frameworks stack.
Ready to standardize your LLM prompt workflow?
Evaluate Prompty's file format, runtimes, and VS Code integration against your team's prompt development and deployment needs. Review the alpha roadmap and version stability expectations before committing to production use.