Metadata-Version: 2.4
Name: vermillio-sdk
Version: 0.0.5
Summary: SDKs for interacting with Vermillio's various APIs.
Project-URL: Homepage, https://vermill.io
Project-URL: Documentation, https://docs.vermill.io
Project-URL: Repository, https://gitlab.com/vermillio-public/vermillio-sdk.git
Project-URL: Issues, https://gitlab.com/vermillio-public/vermillio-sdk/-/issues
Requires-Python: >=3.9
Requires-Dist: tqdm>=4.67.1
Requires-Dist: vermillio-core-sdk==0.0.5
Provides-Extra: guardrails
Requires-Dist: vermillio-guardrails-sdk==0.0.5; extra == 'guardrails'
Provides-Extra: ml
Requires-Dist: vermillio-ml-sdk==0.0.5; extra == 'ml'
Provides-Extra: music
Requires-Dist: vermillio-music-sdk==0.0.5; extra == 'music'
Description-Content-Type: text/markdown

# Vermillio SDK

Entrypoint for Vermillio's various SDK's for interacting with Vermillio API's.

## Guardrails SDK

### Installing

```bash
pip install vermillio-sdk[guardrails]
uv add vermillio-sdk[guardrails]
```


### Getting Started

```python
from vermillio.sdk.guardrails import VermillioGuardrails, GuardrailsExternalSource

client = VermillioGuardrails()

sources = [
    GuardrailsExternalSource(
        prompt="Write a song about a flying hero from Krypton.",
    )
]

results = client.run_results(sources)
if results:
    first = results[0]
    print(first.summary)
```

## Music SDK

### Installing

```bash
pip install vermillio-sdk[music]
uv add vermillio-sdk[music]
```

### Getting Started

```python
from vermillio.sdk.music import VermillioMusicAIDetect, AIDetectExternalSource

ai_detect = VermillioMusicAIDetect()
result = next(iter(ai_detect.run_results([
    AIDetectExternalSource(path="https://example.com/track.wav"),
] or [])), None)

if result and result.status == 'Succeeded':
    for detection in result.results.detections:
        confidence = f"({detection.confidence:0.2f})" if detection.confidence else "--"
        print(f"[{detection.query_segment.start:0.2f}-{detection.query_segment.end:0.2f}] {segment.label} {confidence}")
```