prompt-versioner 0.1.3

Intelligent versioning system for LLM prompts with Git integration

A comprehensive Python library for managing and versioning LLM prompts, with built-in A/B testing, metric tracking, and performance monitoring capabilities.

---

🎯 Why Prompt Versioner?

Prompt Versioner provides enterprise-grade prompt management with:

• 🔄 Version Control: Full versioning of prompts
• 📊 Performance Tracking: Metrics and regression detection
• 🧪 A/B Testing: Built-in statistical framework
• ⚡ Real-time Monitoring: Alerts and dashboards
• 👥 Team Collaboration: Annotations and reviews
• 🎨 Modern UI: Responsive web dashboard

---

✨ Features

🔧 Core Functionality

• Automatic MAJOR/MINOR/PATCH versioning
• Metrics tracking: tokens, latency, quality, cost
• Export & share prompt history
• Optional Git integration

🧪 Advanced Testing & Monitoring

• A/B Testing framework
• Automated regression detection
• Live metrics dashboards
• Custom alert thresholds

👥 Collaboration & Management

• Team annotations and feedback
• Version comparison & visual diff
• Search & filtering by metadata, performance, and tags

🎨 Modern Web Interface

• Interactive dashboard with responsive layout
• Dark/Light themes
• Tab navigation for Prompts, Testing, Comparison, Alerts
• Real-time updates

---

📦 Installation

Prerequisites

• Python 3.11+
• Poetry (recommended) or pip
• Git (optional)

Using Poetry

poetry add git+https://github.com/pepes97/prompt-versioner.git

Using pip

pip install git+https://github.com/pepes97/prompt-versioner.git

---

🚀 Quick Start

from prompt_versioner import PromptVersioner, VersionBump

pv = PromptVersioner(project_name="my-first-project", enable_git=False)
pv.save_version(
    name="assistant",
    system_prompt="You are a helpful assistant.",
    user_prompt="Please answer the following question: {question}",
    bump_type=VersionBump.MAJOR
)

print("✅ Created first prompt version 1.0.0!")

---

🎨 Web Dashboard

Core Features

📋 Prompts Management

• Version history with visual diff
• Semantic search
• Bulk operations
• Live preview

📊 Metrics & Analytics

• Token usage, latency, cost analysis
• Quality score tracking

🧪 A/B Testing

• Split testing
• Real-time results

🔍 Version Comparison

• Side-by-side visual diff
• Metadata & performance delta
• Smart annotations

⚠️ Smart Alerts

• Automatic detection of regressions
• Cost and error monitoring
• Custom metrics & thresholds

---

💻 CLI Interface

pv init
pv list
pv versions <prompt>
pv show <prompt> <version>
pv diff <prompt> <v1> <v2>
pv compare <prompt> <v1> <v2>
pv delete <prompt> <version>
pv rollback <prompt> <version>
pv dashboard --port 5000

---

📖 Examples

Examples in examples/ are fully functional:

File	Description
basic_usage.py	Getting started
version_management.py	Advanced version control
metrics_tracking.py	Metrics logging
ab_testing.py	Statistical testing
performance_monitoring.py	Automated monitoring
summarization_example.py	Real-world summarization
run_dashboard.py	Launch dashboard
clear_db.py	Reset database

---

🌟 Contributing

See CONTRIBUTING.md for contribution guidelines.

---

📄 License

MIT License - LICENSE

---

📞 Support

• Documentation: https://pepes97.github.io/prompt-versioner/
• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

Build by Sveva Pepe, NLP Engineer
_{⭐ Star this project if it helps you build better AI applications!}