Metadata-Version: 2.4
Name: promptjuggler
Version: 1.0.0
Summary: Python SDK for the PromptJuggler API — run prompts and workflows, manage knowledge bases, and verify webhooks.
Project-URL: Homepage, https://docs.promptjuggler.com/sdks/python/overview
Project-URL: Repository, https://github.com/motleyhand/promptjuggler-python-sdk
Author: PromptJuggler
License-Expression: MIT
Keywords: ai,llm,promptjuggler,prompts,sdk
Requires-Python: >=3.10
Requires-Dist: pydantic>=2
Requires-Dist: python-dateutil>=2.8
Requires-Dist: typing-extensions>=4.7
Requires-Dist: urllib3>=2
Provides-Extra: dev
Requires-Dist: mypy>=1.13; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Description-Content-Type: text/markdown

# PromptJuggler Python SDK

The official Python client for the [PromptJuggler](https://promptjuggler.com) API. Run
prompts and workflows, manage knowledge bases, and verify webhooks — with pydantic-typed
models and flat, synchronous methods.

## Requirements

- Python 3.10+

## Installation

```bash
pip install promptjuggler
```

## Usage

```python
from promptjuggler import PromptJuggler, RunStatus

pj = PromptJuggler("your-api-key")

# Trigger a run (async — returns the run ID)
created = pj.run_prompt("greeting", "production", {"name": "Ada"})

# Poll for the result
run = pj.get_prompt_run(created.id)
if run.status == RunStatus.COMPLETED:
    print(run.output)
```

Errors surface as `ApiError` (with a `status_code`). Verify incoming webhooks with
`verify_webhook_signature()`.

## Documentation

Full guides and the API reference: **https://docs.promptjuggler.com/sdks/python/overview**

## License

MIT
