Metadata-Version: 2.4
Name: sonusai-asr-cloud
Version: 1.3.2
Summary: Cloud ASR tools for SonusAI
Project-URL: Homepage, https://aaware.com
Author-email: Chris Eddington <chris@aaware.com>, Jason Calderwood <jason@aaware.com>
License-Expression: GPL-3.0-only
Requires-Python: <3.15,>=3.13
Requires-Dist: aixplain>=0.2.41
Requires-Dist: deepgram-sdk>=7.4.0
Requires-Dist: sonusai>=1.3.3
Requires-Dist: speechrecognition>=3.17.0
Description-Content-Type: text/markdown

# SonusAI ASR Cloud

Cloud ASR tools for SonusAI.

SonusAI ASR Cloud provides provider-specific adapters for cloud speech-to-text services and normalizes responses into SonusAI ASR result types.

## Key Features

- **Multiple Cloud Providers**: aiXplain Whisper, Deepgram, and SpeechRecognition (Google Cloud Speech API).
- **Unified Return Type**: Provider outputs are normalized to `ASRResult`.
- **Validation Helpers**: Each provider includes config/environment validation helpers.
- **SonusAI Integration**: Uses SonusAI datatypes and utility helpers for audio conversion and output formatting.

## Getting Started

### Prerequisites
- Python `3.13` or `3.14`
- `uv`

### Install
```bash
uv sync
source .venv/bin/activate
```

## Provider Requirements

- **aiXplain Whisper**
  - Pass `model` in provider config.
  - Set environment variable: `AIXP_WHISPER_<MODEL>`.
- **Deepgram**
  - Set environment variable: `DEEPGRAM_API_KEY`.
- **Google (SpeechRecognition)**
  - Configure runtime credentials for Google Cloud Speech as required by the underlying backend.

## Usage Notes

Provider functions live under `sonusai_asr_cloud/asr_functions/` and expose:
- `*_validate(**config)` for preflight checks.
- provider call function (for example `deepgram(audio, **config)`) returning `ASRResult`.

## Development

- **Development Guide**: [docs/development.md](docs/development.md)
- **Agent/Contributor Guidance**: [CLAUDE.md](CLAUDE.md)

### Common Commands
```bash
pytest
./build_wheels.sh
./publish.sh
```

## Project Context

- [Overview](docs/internal/overview.md)
- [Architecture](docs/internal/architecture.md)
- [Standards](docs/internal/standards.md)
- [Directory Map](docs/internal/directory_map.md)
- [CLI & Commands](docs/internal/cli_commands.md)
