Metadata-Version: 2.4
Name: vermillio-sdk
Version: 0.0.8
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.8
Provides-Extra: assets
Requires-Dist: vermillio-assets-sdk==0.0.8; extra == 'assets'
Provides-Extra: guardrails
Requires-Dist: vermillio-guardrails-sdk==0.0.8; extra == 'guardrails'
Provides-Extra: ml
Requires-Dist: vermillio-ml-sdk==0.0.8; extra == 'ml'
Provides-Extra: music
Requires-Dist: vermillio-music-sdk==0.0.8; 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()

result = client.run_results(GuardrailsExternalSource(
    prompt="Write a song about a flying hero from Krypton.",
))
if result:
    if result.status == 'Succeeded':
        print(result.summary)
    else:
        print(result.status)
```

## 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 = ai_detect.run_results(
    AIDetectExternalSource(path="https://example.com/track.wav"),
)

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}")
```
