promptcraft-py 0.1.0

A lightweight toolkit for prompt engineering, optimization, and evaluation

🎯 PromptCraft

A lightweight Python toolkit for prompt engineering, optimization, and evaluation.

PromptCraft helps developers build, test, and refine prompts for LLMs with a clean, composable API.

✨ Features

• Prompt Builder — Chain instructions, examples, and variables with a fluent API
• Template System — Reusable prompt templates with variable interpolation
• Optimizer — Automatically refine prompts using scoring and iteration
• Evaluator — Score prompt quality across clarity, specificity, and completeness
• Multi-provider — Works with OpenAI, Anthropic, and any OpenAI-compatible API
• Zero dependencies — Core library has no external dependencies

🚀 Quick Start

pip install promptcraft

from promptcraft import PromptBuilder, Template

# Build a prompt
prompt = (
    PromptBuilder()
    .system("You are a helpful coding assistant.")
    .instruction("Explain the following concept clearly.")
    .variable("concept", "dependency injection")
    .examples([
        {"input": "What is recursion?", "output": "Recursion is when a function calls itself..."}
    ])
    .build()
)

print(prompt)

Using Templates

from promptcraft import Template

# Define a reusable template
review_template = Template(
    name="code_review",
    system="You are a senior code reviewer.",
    instruction="Review the following {language} code for bugs and improvements.",
    variables=["language", "code"]
)

# Render with specific values
prompt = review_template.render(
    language="Python",
    code="def add(a, b): return a"
)

Optimizing Prompts

from promptcraft import Optimizer

optimizer = Optimizer(
    metric="relevance",
    iterations=5
)

optimized = optimizer.optimize(
    prompt="Explain {topic}",
    test_cases=[
        {"topic": "quantum computing", "expected_keywords": ["qubit", "superposition"]},
        {"topic": "machine learning", "expected_keywords": ["model", "training"]},
    ]
)

print(f"Score improved from {optimized.initial_score:.2f} to {optimized.final_score:.2f}")

Evaluating Prompts

from promptcraft import Evaluator

evaluator = Evaluator()
result = evaluator.score(
    prompt="Write a function that sorts a list",
    criteria=["clarity", "specificity", "completeness"]
)

print(f"Overall: {result.overall:.2f}")
print(f"Clarity: {result.scores['clarity']:.2f}")

📦 Installation

# From PyPI
pip install promptcraft

# From source
git clone https://github.com/USER/PromptCraft.git
cd PromptCraft
pip install -e .

🧪 Running Tests

# Run all tests
pytest

# With coverage
pytest --cov=promptcraft --cov-report=term-missing

📚 Documentation

• Getting Started
• API Reference
• Examples
• Contributing

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md for details.

📄 License

This project is licensed under the MIT License — see LICENSE for details.