willow-inference-server

# Willow Inference Server Skill

Local ASR (speech-to-text) and TTS (text-to-speech) inference server.

## Setup

### 1. Start Willow Inference Server
```bash
git clone https://github.com/toverainc/willow-inference-server.git
cd willow-inference-server
./utils.sh install
./utils.sh gen-cert your-hostname
./utils.sh run
```

Server runs at `https://your-hostname:19000`

### 2. Configure Environment
Set the server URL:
```bash
export WILLOW_BASE_URL="https://your-hostname:19000"
```

Or configure per request (see below).

## ASR (Speech-to-Text)

### Transcribe Audio File
```bash
curl -X POST "${WILLOW_BASE_URL}/asr" \
  -F "audio_file=@/path/to/audio.m4a" \
  -F "language=auto"
```

### Parameters
| Parameter | Description | Default |
|-----------|-------------|---------|
| audio_file | Audio file to transcribe | required |
| language | Language code (en, zh, etc.) or "auto" | auto |
| model | Whisper model (tiny, base, medium, large-v2) | server config |
| task | transcribe or translate | transcribe |

### Supported Formats
- MP3, WAV, M4A, OGG, FLAC, WebM

### Example: Transcribe with curl
```bash
# Basic transcription
curl -X POST "${WILLOW_BASE_URL}/asr" \
  -F "audio_file=@recording.m4a" \
  -F "language=zh"

# With specific model
curl -X POST "${WILLOW_BASE_URL}/asr" \
  -F "audio_file=@meeting.mp3" \
  -F "language=en" \
  -F "model=base"
```

## TTS (Text-to-Speech)

### Convert Text to Speech
```bash
curl -X POST "${WILLOW_BASE_URL}/tts" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world", "voice": "af_sarah"}'
```

### Parameters
| Parameter | Description | Default |
|-----------|-------------|---------|
| text | Text to convert to speech | required |
| voice | Voice ID (see below) | default voice |
| speed | Speech speed (0.5-2.0) | 1.0 |
| volume | Volume (0.0-1.0) | 1.0 |

### Available Voices
Common voices (format: `gender_voicename`):
- `af_sarah` - Sarah (Female)
- `af_bella` - Bella (Female)
- `am_michael` - Michael (Male)
- `am_al...