refactor: add named prefix to all STT compat routers

JarbasAl · claude · JarbasAl · commit 1fd4acbebc87 · 2026-03-18T02:15:30.000Z
Each compat router now mounts under a prefix that identifies the API vendor:
  /openai/v1/...             OpenAI Whisper
  /deepgram/v1/...           Deepgram
  /google/v1/...             Google Cloud STT
  /assemblyai/v2/...         AssemblyAI
  /speechmatics/v1/...       Speechmatics

Benefits: all routers coexist with no path conflicts; Swagger groups by vendor.

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/.github/workflows/license_tests.yml b/.github/workflows/license_tests.yml
@@ -1,12 +1,15 @@
 name: Run License Tests
 on:
   push:
-  workflow_dispatch:
-  pull_request:
     branches:
       - master
+  pull_request:
+    branches:
+      - dev
+  workflow_dispatch:
+
 jobs:
   license_tests:
-    uses: neongeckocom/.github/.github/workflows/license_tests.yml@master
+    uses: OpenVoiceOS/gh-automations/.github/workflows/license-check.yml@dev
     with:
-      packages-exclude: '^(tqdm|bs4|gradio|bitstruct|attrs|referencing).*'
+      exclude_packages: '^(tqdm|bs4|gradio|bitstruct|attrs|referencing).*'
diff --git a/.github/workflows/notify_matrix.yml b/.github/workflows/notify_matrix.yml
diff --git a/.github/workflows/publish_stable.yml b/.github/workflows/publish_stable.yml
@@ -6,53 +6,12 @@ on:
 
 jobs:
   publish_stable:
-    uses: TigreGotico/gh-automations/.github/workflows/publish-stable.yml@master
+    if: github.actor != 'github-actions[bot]'
+    uses: OpenVoiceOS/gh-automations/.github/workflows/publish-stable.yml@dev
     secrets: inherit
     with:
       branch: 'master'
       version_file: 'ovos_stt_http_server/version.py'
-      setup_py: 'setup.py'
+      publish_pypi: true
+      sync_dev: true
       publish_release: true
-
-  publish_pypi:
-    needs: publish_stable
-    if: success()  # Ensure this job only runs if the previous job succeeds
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          ref: master
-          fetch-depth: 0 # otherwise, there would be errors pushing refs to the destination repository.
-      - name: Setup Python
-        uses: actions/setup-python@v6
-        with:
-          python-version: "3.14"
-      - name: Install Build Tools
-        run: |
-          python -m pip install build wheel
-      - name: version
-        run: echo "::set-output name=version::$(python setup.py --version)"
-        id: version
-      - name: Build Distribution Packages
-        run: |
-          python setup.py sdist bdist_wheel
-      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@master
-        with:
-          password: ${{secrets.PYPI_TOKEN}}
-
-
-  sync_dev:
-    needs: publish_stable
-    if: success()  # Ensure this job only runs if the previous job succeeds
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0 # otherwise, there would be errors pushing refs to the destination repository.
-          ref: master
-      - name: Push master -> dev
-        uses: ad-m/github-push-action@master
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          branch: dev
diff --git a/.github/workflows/release_workflow.yml b/.github/workflows/release_workflow.yml
@@ -8,101 +8,16 @@ on:
 
 jobs:
   publish_alpha:
-    uses: TigreGotico/gh-automations/.github/workflows/publish-alpha.yml@master
+    if: github.event.pull_request.merged == true || github.event_name == 'workflow_dispatch'
+    uses: OpenVoiceOS/gh-automations/.github/workflows/publish-alpha.yml@dev
     secrets: inherit
     with:
       branch: 'dev'
       version_file: 'ovos_stt_http_server/version.py'
-      setup_py: 'setup.py'
       update_changelog: true
       publish_prerelease: true
+      propose_release: true
       changelog_max_issues: 100
-
-  notify:
-    if: github.event.pull_request.merged == true
-    needs: publish_alpha
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - name: Send message to Matrix bots channel
-        id: matrix-chat-message
-        uses: fadenb/matrix-chat-message@v0.0.6
-        with:
-          homeserver: 'matrix.org'
-          token: ${{ secrets.MATRIX_TOKEN }}
-          channel: '!WjxEKjjINpyBRPFgxl:krbel.duckdns.org'
-          message: |
-            new ${{ github.event.repository.name }} PR merged! https://github.com/${{ github.repository }}/pull/${{ github.event.number }}
-
-  publish_pypi:
-    needs: publish_alpha
-    if: success()  # Ensure this job only runs if the previous job succeeds
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          ref: dev
-          fetch-depth: 0 # otherwise, there would be errors pushing refs to the destination repository.
-      - name: Setup Python
-        uses: actions/setup-python@v6
-        with:
-          python-version: "3.14"
-      - name: Install Build Tools
-        run: |
-          python -m pip install build wheel
-      - name: version
-        run: echo "::set-output name=version::$(python setup.py --version)"
-        id: version
-      - name: Build Distribution Packages
-        run: |
-          python setup.py sdist bdist_wheel
-      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@master
-        with:
-          password: ${{secrets.PYPI_TOKEN}}
-
-
-  propose_release:
-    needs: publish_alpha
-    if: success()  # Ensure this job only runs if the previous job succeeds
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout dev branch
-        uses: actions/checkout@v6
-        with:
-          ref: dev
-
-      - name: Setup Python
-        uses: actions/setup-python@v6
-        with:
-          python-version: '3.14'
-
-      - name: Get version from setup.py
-        id: get_version
-        run: |
-          VERSION=$(python setup.py --version)
-          echo "VERSION=$VERSION" >> $GITHUB_ENV
-
-      - name: Create and push new branch
-        run: |
-          git checkout -b release-${{ env.VERSION }}
-          git push origin release-${{ env.VERSION }}
-
-      - name: Open Pull Request from dev to master
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          # Variables
-          BRANCH_NAME="release-${{ env.VERSION }}"
-          BASE_BRANCH="master"
-          HEAD_BRANCH="release-${{ env.VERSION }}"
-          PR_TITLE="Release ${{ env.VERSION }}"
-          PR_BODY="Human review requested!"
-
-          # Create a PR using GitHub API
-          curl -X POST \
-            -H "Accept: application/vnd.github+json" \
-            -H "Authorization: token $GITHUB_TOKEN" \
-            -d "{\"title\":\"$PR_TITLE\",\"body\":\"$PR_BODY\",\"head\":\"$HEAD_BRANCH\",\"base\":\"$BASE_BRANCH\"}" \
-            https://api.github.com/repos/${{ github.repository }}/pulls
+      publish_pypi: true
+      notify_matrix: true
 
diff --git a/ovos_stt_http_server/routers/assemblyai.py b/ovos_stt_http_server/routers/assemblyai.py
@@ -46,7 +46,7 @@ class AssemblyAITranscript(BaseModel):
 
 def make_assemblyai_router(model) -> APIRouter:
     """Create AssemblyAI-compatible router (synchronous stub)."""
-    router = APIRouter(prefix="/v2", tags=["assemblyai"])
+    router = APIRouter(prefix="/assemblyai/v2", tags=["assemblyai"])
 
     @router.post("/transcript", response_model=AssemblyAITranscript)
     def create_transcript(
diff --git a/ovos_stt_http_server/routers/deepgram.py b/ovos_stt_http_server/routers/deepgram.py
@@ -52,7 +52,7 @@ class DeepgramResponse(BaseModel):
 
 def make_deepgram_router(model) -> APIRouter:
     """Create Deepgram-compatible router."""
-    router = APIRouter(tags=["deepgram"])
+    router = APIRouter(prefix="/deepgram", tags=["deepgram"])
 
     @router.post("/v1/listen", response_model=DeepgramResponse)
     async def listen(
diff --git a/ovos_stt_http_server/routers/google_stt.py b/ovos_stt_http_server/routers/google_stt.py
@@ -50,7 +50,7 @@ class GoogleSTTResponse(BaseModel):
 
 def make_google_stt_router(model) -> APIRouter:
     """Create Google Cloud STT-compatible router."""
-    router = APIRouter(tags=["google-stt"])
+    router = APIRouter(prefix="/google", tags=["google-stt"])
 
     @router.post("/v1/speech:recognize", response_model=GoogleSTTResponse)
     def recognize(
diff --git a/ovos_stt_http_server/routers/openai_whisper.py b/ovos_stt_http_server/routers/openai_whisper.py
@@ -37,7 +37,7 @@ def make_openai_whisper_router(model) -> APIRouter:
     Returns:
         Configured APIRouter with OpenAI-compatible transcription endpoints.
     """
-    router = APIRouter(tags=["openai-whisper"])
+    router = APIRouter(prefix="/openai", tags=["openai-whisper"])
 
     async def _transcribe(
             file: UploadFile,
diff --git a/ovos_stt_http_server/routers/speechmatics.py b/ovos_stt_http_server/routers/speechmatics.py
@@ -52,7 +52,7 @@ class SpeechmaticsTranscriptResponse(BaseModel):
 
 def make_speechmatics_router(model) -> APIRouter:
     """Create Speechmatics-compatible router (synchronous stub)."""
-    router = APIRouter(prefix="/v1", tags=["speechmatics"])
+    router = APIRouter(prefix="/speechmatics/v1", tags=["speechmatics"])
 
     @router.post("/jobs", response_model=SpeechmaticsJobResponse)
     async def create_job(
diff --git a/ovos_stt_http_server/version.py b/ovos_stt_http_server/version.py
@@ -4,3 +4,5 @@
 VERSION_BUILD = 5
 VERSION_ALPHA = 7
 # END_VERSION_BLOCK
+
+__version__ = f"{VERSION_MAJOR}.{VERSION_MINOR}.{VERSION_BUILD}" + (f"a{VERSION_ALPHA}" if VERSION_ALPHA else "")
diff --git a/test/unittests/test_compat_routers.py b/test/unittests/test_compat_routers.py
