PromptLib Ultimate 🚀

A powerful and comprehensive Python library for managing Large Language Model (LLM) prompts, offering a modern Graphical User Interface (GUI), a robust Command-Line Interface (CLI), and a flexible Application Programming Interface (API).

✨ Features

PromptLib Ultimate is designed to streamline prompt engineering and management with a rich set of features:

• Modern GUI: Built with PySide6, providing an intuitive and aesthetically pleasing user experience for prompt creation, editing, and management.
• Hybrid Search: Combines traditional text-based search with advanced semantic search capabilities, powered by vector embeddings, to help you find the most relevant prompts quickly.
• Execution Engine: A sophisticated engine for processing variables and generating final prompts, ensuring dynamic and context-aware prompt generation.
• Prompt Optimization: Intelligent tools and suggestions to refine and improve your prompts, enhancing LLM performance and output quality.
• Local Storage: Utilizes a fast and secure SQLite database for efficient local storage of all your prompt data, ensuring privacy and quick access.
• API & CLI: Offers both a programmatic API for seamless integration into other Python applications and a powerful CLI for scriptable prompt management.

🛠️ Installation

To get started with PromptLib Ultimate, follow these simple steps:

1. Clone the repository (or download the project and navigate to its directory):

   git clone https://github.com/Alqudimi/promptlib-ultimate.git
   cd promptlib-ultimate

2. Install dependencies and the project using pip:

   pip install .

🚀 Usage

PromptLib Ultimate provides multiple ways to interact with your prompts:

1. Graphical User Interface (GUI)

Launch the elegant GUI for an interactive experience:

promptlib-gui

2. Command-Line Interface (CLI)

Interact with the library directly from your terminal:

promptlib-cli --help

3. Python API

Integrate PromptLib into your Python applications:

from promptlib.core.api import PromptLib

# Initialize the library
lib = PromptLib()

# Create a new prompt
prompt = lib.create_prompt("Greeting", "Hello, my name is {name}!")

# Render the prompt with variables
result = lib.render(prompt.id, {"name": "Abdulaziz"})
print(result) # Output: Hello, my name is Abdulaziz!

# Example of semantic search
search_results = lib.search_prompts("greeting message", semantic=True)
for p in search_results:
    print(f"Found prompt: {p.name}")

📂 Project Structure

The project adheres to a modular and clean architecture:

promptlib-ultimate/
├── promptlib/              # Main source code
│   ├── core/               # Core engine and models
│   ├── gui/                # PySide6 Graphical User Interface
│   ├── storage/            # Database management (SQLite)
│   ├── services/           # Search, execution, and optimization engines
│   ├── cli/                # Command-Line Interface implementation
│   └── ...                 # Other modules (e.g., embeddings, agents, workflows)
├── tests/                  # Unit and integration tests
├── docs/                   # Documentation and assets
├── setup.py                # Project installation and distribution
├── requirements.txt        # Python dependencies
├── LICENSE                 # Project license
└── README.md               # This README file

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

📄 License

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

© Copyright

Copyright © 2026 Abdulaziz Alqudimi. All rights reserved.

---

Developed with passion by Abdulaziz Alqudimi.