Welcome to Prompty

Prompty is a file format (.prompty) for LLM prompts. Write your prompt once — model config, inputs, tools, and template in a single markdown file — then run it from Python, TypeScript, C#, or Rust. Treat prompts as code: version them in git, test them in CI, share them across teams, and deploy with confidence.

Choose Your Path

🚀 I'm New to Prompty Start from scratch — install, write your first prompt, and run it in under 5 minutes.

🔄 I'm Migrating from v1 What changed, what's new, and how to update your existing .prompty files.

⚡ I Know the Basics Jump to how-to guides, tool calling, streaming, structured output, and more.

Quick Example

---
name: greeting
model:
  id: gpt-4o-mini
  provider: openai
  connection:
    kind: key
    apiKey: ${env:OPENAI_API_KEY}
inputs:
  - name: userName
    kind: string
    default: World
---
system:
You are a friendly assistant.

user:
Say hello to {{userName}}.

Python

import prompty
result = prompty.invoke("greeting.prompty", inputs={"userName": "Jane"})

TypeScript

import { invoke } from "@prompty/core";
const result = await invoke("greeting.prompty", { userName: "Jane" });

C#

using Prompty.Core;
var result = await Pipeline.InvokeAsync("greeting.prompty", new() { ["userName"] = "Jane" });

Rust

use serde_json::json;

prompty::register_defaults();
prompty_openai::register();

let result = prompty::invoke_from_path(
    "greeting.prompty",
    Some(&json!({ "userName": "Jane" })),
).await?;

What Can You Build?

• Chat assistants — Getting Started
• RAG pipelines — How-To: Embeddings
• Tool-calling agents — How-To: Agent Tool Calling
• Structured data extraction — How-To: Structured Output
• Image generation — How-To: Image Generation

Key Features

• Four runtimes — Python, TypeScript, C#, and Rust
• Pipeline architecture — render → parse → execute → process, each stage swappable
• Built-in tracing — console, JSON file, and OpenTelemetry backends
• Provider support — OpenAI, Azure / Foundry, and Anthropic
• VS Code extension — syntax highlighting, autocomplete, live preview, and trace viewer

Learn More

📖 Core Concepts File format, pipeline, connections, tools, and tracing.

📋 Schema Reference Every frontmatter property documented.

🐍 Python Runtime Installation, API reference, and provider guides.

📘 TypeScript Runtime Installation, API reference, and provider guides.

Contributing

Prompty is open source. We welcome contributions to the runtimes, tooling, and documentation. See the Contributing guide to get started.