@mastra/voice-cloudflare/README.md

Mastra Cloudflare AI voice integration

# @mastra/voice-cloudflare

Cloudflare Voice integration for Mastra, providing Text-to-Speech (TTS) capabilities using open source speech models.

## Installation

```bash
npm install @mastra/voice-cloudflare
```

## Configuration

The module requires the following environment variables:

If using Cloudflare Native Bindings:

`./wrangler.jsonc`

```json
"ai": {
    "binding": "AI",
  },
```

If using Cloudflare REST API:

```bash
CLOUDFLARE_AI_API_KEY=your_api_key
CLOUDFLARE_ACCOUNT_ID=your_account_id
```

## Usage

```typescript
import { CloudflareVoice } from '@mastra/voice-cloudflare';

// Native Bindings
const voice = new CloudflareVoice({
  binding: env.AI,
  listeningModel: {
    model: '@cf/openai/whisper-large-v3-turbo',
  },
});

// REST API
const voice = new CloudflareVoice({
  listeningModel: {
    apiKey: 'YOUR_API_KEY',
    model: '@cf/openai/whisper-large-v3-turbo',
    account_id: 'YOUR_ACC_ID',
  },
});

// Generate Text from an audio stream
const text = await voice.listen(audioStream);
```

## Features

- Open source models

## Available Models

### Speech Models

The following speech-to-text models are available:

| Model                               | Description                    |
| ----------------------------------- | ------------------------------ |
| `@cf/openai/whisper-tiny-en`        | Lightweight English-only model |
| `@cf/openai/whisper`                | Standard multilingual model    |
| `@cf/openai/whisper-large-v3-turbo` | High-accuracy turbo model      |