Voice SDK 0.1.26

Python SDK for building voice-enabled applications with the Speechmatics Real-Time API. Optimized for conversational AI, voice agents, transcription services, and real-time captioning.

The Voice SDK is a higher-level abstraction built on top of the Speechmatics Real-Time API (`speechmatics-rt`).

Author: sam-s10s

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,18 +1,21 @@
 ---
 name: Bug report
 about: Create a report to help us improve
-title: '[BUG] '
-labels: 'bug'
-assignees: ''
+title: "[BUG] "
+labels: "bug"
+assignees: ""
 ---
 
 **Which SDK are you using?**
+
 - [ ] speechmatics-rt (Real-Time SDK)
 - [ ] speechmatics-batch (Batch SDK)
-- [ ] Both
+- [ ] speechmatics-voice (Voice SDK)
+- [ ] All
 
 **Package Information**
-- **Package Name**: (e.g., speechmatics-rt, speechmatics-batch)
+
+- **Package Name**: (e.g., speechmatics-rt, speechmatics-batch, speechmatics-voice)
 - **Package Version**: (e.g., 1.0.0)
 - **Python Version**: (e.g., 3.9, 3.10, 3.11, 3.12, 3.13)
 - **Operating System**: (e.g., Windows 10, macOS 12, Ubuntu 20.04)
@@ -22,6 +25,7 @@ A clear and concise description of what the bug is.
 
 **To Reproduce**
 Steps to reproduce the behavior:
+
 1.
 2.
 

.github/ISSUE_TEMPLATE/question.md

@@ -1,21 +1,24 @@
 ---
 name: Question
 about: Ask a question or request support
-title: '[QUESTION] '
-labels: 'question'
-assignees: ''
+title: "[QUESTION] "
+labels: "question"
+assignees: ""
 ---
 
 **Which SDK is your question about?**
+
 - [ ] speechmatics-rt (Real-Time SDK)
 - [ ] speechmatics-batch (Batch SDK)
-- [ ] Both SDKs
+- [ ] speechmatics-voice (Voice SDK)
+- [ ] All
 - [ ] General usage question
 - [ ] Setup/Installation
 - [ ] Not sure
 
 **Package Information** (if applicable)
-- **Package Name**: (e.g., speechmatics-rt, speechmatics-batch)
+
+- **Package Name**: (e.g., speechmatics-rt, speechmatics-batch, speechmatics-voice)
 - **Package Version**: (e.g., 1.0.0)
 - **Python Version**: (e.g., 3.9, 3.10, 3.11, 3.12, 3.13)
 - **Operating System**: (e.g., Windows 10, macOS 12, Ubuntu 20.04)
@@ -35,4 +38,5 @@ What result or behavior are you hoping to achieve?
 
 **Related issues**
 Link any related issues or discussions:
+
 - Related to #

.github/RELEASE.md

@@ -5,9 +5,11 @@ This document outlines the release process for the Speechmatics Python SDK packa
 ## Overview
 
 The Speechmatics Python SDK repository contains two separate packages:
+
 - `speechmatics-rt` - Real-Time API Client
 - `speechmatics-batch` - Batch API Client
 - `speechmatics-flow` - Flow API Client
+- `speechmatics-voice` - Voice Agent API Client
 
 Each package is released independently with its own versioning and release workflow.
 
@@ -16,17 +18,20 @@ Each package is released independently with its own versioning and release workf
 Before creating a release, ensure the following steps are completed:
 
 ### Code Quality
+
 - [ ] All tests pass locally (`make test-all`)
 - [ ] Linting passes (`make lint-all`)
 - [ ] Type checking passes (`make type-check-all`)
 - [ ] Examples work correctly with the new version
 - [ ] Documentation is up to date
 
 ### Version Management
+
 - [ ] Review and update README files if needed
 - [ ] Verify dependencies are correct in `pyproject.toml`
 
 ### Testing
+
 - [ ] Test examples with fresh installations
 - [ ] Verify environment variables work correctly
 - [ ] Test error handling scenarios
@@ -39,13 +44,15 @@ Before creating a release, ensure the following steps are completed:
 To release a new version of the RT SDK:
 
 1. **Create a Release Tag**
+
    ```bash
    git tag rt/v1.0.0
    git push origin rt/v1.0.0
    ```
 
 2. **Automated Workflow**
    The `release-rt.yaml` workflow will automatically:
+
    - Extract version from tag (e.g., `rt/v1.0.0` → `1.0.0`)
    - Run comprehensive tests across Python versions
    - Update version in `sdk/rt/speechmatics/rt/__init__.py`
@@ -63,13 +70,15 @@ To release a new version of the RT SDK:
 To release a new version of the Batch SDK:
 
 1. **Create a Release Tag**
+
    ```bash
    git tag batch/v1.0.0
    git push origin batch/v1.0.0
    ```
 
 2. **Automated Workflow**
    The `release-batch.yaml` workflow will automatically:
+
    - Extract version from tag (e.g., `batch/v1.0.0` → `1.0.0`)
    - Run comprehensive tests across Python versions
    - Update version in `sdk/batch/speechmatics/batch/__init__.py`
@@ -87,13 +96,15 @@ To release a new version of the Batch SDK:
 To release a new version of the Flow SDK:
 
 1. **Create a Release Tag**
+
    ```bash
    git tag flow/v1.0.0
    git push origin flow/v1.0.0
    ```
 
 2. **Automated Workflow**
    The `release-flow.yaml` workflow will automatically:
+
    - Extract version from tag (e.g., `flow/v1.0.0` → `1.0.0`)
    - Run comprehensive tests across Python versions
    - Update version in `sdk/flow/speechmatics/flow/__init__.py`
@@ -106,36 +117,72 @@ To release a new version of the Flow SDK:
    - Update GitHub release notes
    - Announce the release
 
+### 4. Voice Agent SDK Release
+
+To release a new version of the Voice Agent SDK:
+
+1. **Create a Release Tag**
+
+   ```bash
+   git tag voice/v1.0.0
+   git push origin voice/v1.0.0
+   ```
+
+2. **Automated Workflow**
+   The `release-voice.yaml` workflow will automatically:
+
+   - Extract version from tag (e.g., `voice/v1.0.0` → `1.0.0`)
+   - Run comprehensive tests across Python versions
+   - Update version in `sdk/voice/speechmatics/voice/__init__.py`
+   - Build the package
+   - Publish to PyPI
+
+3. **Manual Steps After Release**
+   - Verify the package is available on PyPI
+   - Test installation: `pip install speechmatics-voice==1.0.0`
+   - Update GitHub release notes
+   - Announce the release
+
 ## Version Management
 
 ### Version Format
+
 Both packages follow semantic versioning (SemVer):
+
 - `MAJOR.MINOR.PATCH` (e.g., `1.2.3`)
 - `MAJOR.MINOR.PATCH-beta.N` for beta releases (e.g., `1.2.3-beta.1`)
 
 ### Version Update Process
+
 1. **Development**: Versions remain as `0.0.0` in `__init__.py` files
 2. **Release**: GitHub Actions automatically updates the version during release
 3. **Post-Release**: The updated version remains in the repository
 
 ### Tag Naming Convention
+
 - RT SDK: `rt/v{version}` (e.g., `rt/v1.0.0`)
 - Batch SDK: `batch/v{version}` (e.g., `batch/v1.0.0`)
 - Flow SDK: `flow/v{version}` (e.g., `flow/v1.0.0`)
+- Voice Agent SDK: `voice/v{version}` (e.g., `voice/v1.0.0`)
 
 ## Environment Setup
 
 ### PyPI Configuration
+
 Both packages are published to PyPI using GitHub Actions with OpenID Connect (OIDC):
+
 - RT SDK: Uses `pypi-rt` environment
 - Batch SDK: Uses `pypi-batch` environment
 - Flow SDK: Uses `pypi-flow` environment
+- Voice Agent SDK: Uses `pypi-voice` environment
 
 ### Required Secrets
+
 No manual secrets are required as the workflows use OIDC for PyPI authentication.
 
 ## Testing Matrix
 
 Both packages are tested against:
+
 - Python versions: 3.9, 3.10, 3.11, 3.12, 3.13
 - Operating system: Ubuntu (latest)

.github/workflows/release-voice.yaml

@@ -0,0 +1,90 @@
+name: Release Voice Agent SDK
+
+on:
+  push:
+    tags:
+      - "voice/v*"
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  extract-version:
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.extract.outputs.version }}
+    steps:
+      - name: Extract version from tag
+        id: extract
+        run: |
+          # Extract version from tag (voice/v1.0.0 -> 1.0.0)
+          VERSION=${GITHUB_REF#refs/tags/voice/v}
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "Extracted version: $VERSION"
+
+  test-voice:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Test Voice Agent SDK
+        run: |
+          make install-dev
+          make lint-voice
+          make test-voice
+
+  release-build:
+    runs-on: ubuntu-latest
+    needs: [extract-version, test-voice]
+    outputs:
+      version: ${{ needs.extract-version.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Update package version in sdk/voice/speechmatics/voice/__init__.py
+        run: |
+          VERSION="${{ needs.extract-version.outputs.version }}"
+          sed -i "s/0\.0\.0/$VERSION/g" ./sdk/voice/speechmatics/voice/__init__.py
+          echo "Updated version to: $VERSION"
+          cat ./sdk/voice/speechmatics/voice/__init__.py | grep __version__
+
+      - name: Build Voice Agent SDK
+        run: |
+          make install-dev
+          make build-voice
+
+      - name: Upload dist
+        uses: actions/upload-artifact@v4
+        with:
+          name: voice-release-dist
+          path: sdk/voice/dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs: [release-build]
+    environment:
+      name: pypi-voice
+      url: https://pypi.org/project/speechmatics-voice/${{ needs.release-build.outputs.version }}
+
+    steps:
+      - name: Retrieve release dist
+        uses: actions/download-artifact@v4
+        with:
+          name: voice-release-dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+          password: ${{ secrets.PYPI_ORG_TOKEN }}

.github/workflows/test.yaml

@@ -70,6 +70,26 @@ jobs:
       - name: Build Flow SDK
         run: make build-flow
 
+  test-voice:
+    name: Test Voice Agent SDK
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: make install-dev
+      - name: Lint Voice Agent SDK
+        run: make lint-voice
+      - name: Test Voice Agent SDK
+        run: make test-voice
+      - name: Build Voice Agent SDK
+        run: make build-voice
+
   test-tts:
     name: Test TTS SDK
     runs-on: ubuntu-latest

.gitignore

@@ -50,27 +50,12 @@ coverage.xml
 .hypothesis/
 .pytest_cache/
 cover/
+.benchmarks/
 
 # Translations
 *.mo
 *.pot
 
-# Django stuff:
-*.log
-local_settings.py
-db.sqlite3
-db.sqlite3-journal
-
-# Flask stuff:
-instance/
-.webassets-cache
-
-# Scrapy stuff:
-.scrapy
-
-# Sphinx documentation
-docs/_build/
-
 # PyBuilder
 .pybuilder/
 target/
@@ -172,5 +157,16 @@ cython_debug/
 # PyPI configuration file
 .pypirc
 
+# Temporary files / directories
+.tmp/
+tmp/
+
+# Model caches
+.models/
+.cache/
+*.onnx
+*.pkf
+.claude
+
 # Examples
-**/output.wav
+**/output.wav

.pre-commit-config.yaml

@@ -50,6 +50,7 @@ repos:
       - id: bandit
         files: ^sdk/.*/speechmatics/
         args: [-r, -f, json, -ll]
+        additional_dependencies: ["pbr"]
 
   - repo: https://github.com/pre-commit/pygrep-hooks
     rev: v1.10.0