Add speech2text model for offline

.devin/wiki.json

@@ -0,0 +1,24 @@
+{
+  "repo_notes": [
+    {
+      "author": "maintainer",
+      "content": "This repository is the SpeechRecognition Python library. The core implementation is centered in speech_recognition/__init__.py (Recognizer, AudioSource, Microphone, AudioFile), while audio format conversion and FLAC handling are in speech_recognition/audio.py."
+    },
+    {
+      "author": "maintainer",
+      "content": "Engine-specific recognition logic lives under speech_recognition/recognizers/ (google, google_cloud, pocketsphinx, vosk, whisper_local, whisper_api). New recognizer integrations and engine-specific bug fixes should primarily be documented in this area."
+    },
+    {
+      "author": "maintainer",
+      "content": "Execution entry points: speech_recognition/__main__.py for the demo (python -m speech_recognition), and speech_recognition/cli.py for the sprc CLI including Vosk model download."
+    },
+    {
+      "author": "maintainer",
+      "content": "Tests are split between tests/ (core audio and recognizer behavior) and tests/recognizers/ (engine-specific tests). Some tests require optional dependencies or external credentials and may be skipped in local environments."
+    },
+    {
+      "author": "maintainer",
+      "content": "Optional functionality is driven by extras in setup.cfg (audio, pocketsphinx, google-cloud, whisper-local, faster-whisper, openai, groq, vosk). Documentation should make dependency requirements explicit per recognizer."
+    }
+  ]
+}

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/issue_template.md

@@ -0,0 +1,46 @@
+---
+name: Issue
+about: Use this template for bug reports (and so on).
+---
+
+Steps to reproduce
+------------------
+
+1. (How do you make the issue happen? Does it happen every time you try it?)
+2. (Make sure to go into as much detail as needed to reproduce the issue. Posting your code here can help us resolve the problem much faster!)
+3. (If there are any files, like audio recordings, don't forget to include them.)
+
+Expected behaviour
+------------------
+
+(What did you expect to happen?)
+
+Actual behaviour
+----------------
+
+(What happened instead? How is it different from what you expected?)
+
+```
+(If the library threw an exception, paste the full stack trace here)
+```
+
+System information
+------------------
+
+(Delete all the statements that don't apply.)
+
+My **system** is <INSERT SYSTEM HERE>. (For example, "Ubuntu 16.04 LTS x64", "Windows 10 x64", or "macOS Sierra".)
+
+My **Python version** is <INSERT VERSION HERE>. (You can check this by running `python -V`.)
+
+My **Pip version** is <INSERT VERSION HERE>. (You can check this by running `pip -V`.)
+
+My **SpeechRecognition library version** is <INSERT VERSION HERE>. (You can check this by running `python -c "import speech_recognition as sr;print(sr.__version__)"`.)
+
+My **PyAudio library version** is <INSERT VERSION HERE> / I don't have PyAudio installed. (You can check this by running `python -c "import pyaudio as p;print(p.__version__)"`.)
+
+My **microphones** are: (You can check this by running `python -c "import speech_recognition as sr;print(sr.Microphone.list_microphone_names())"`.)
+
+My **working microphones** are: (You can check this by running `python -c "import speech_recognition as sr;print(sr.Microphone.list_working_microphones())"`.)
+
+I **installed PocketSphinx from** <INSERT SOURCE HERE>. (For example, from the Debian repositories, from Homebrew, or from the source code.)

.github/workflows/issues.yml

@@ -0,0 +1,23 @@
+name: Close inactive issues
+
+on:
+  schedule:
+    - cron: "30 1 * * *"
+
+jobs:
+  close-issues:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+      - uses: actions/stale@b5d41d4e1d5dceea10e7104786b73624c18a190f # v10.2.0
+        with:
+          days-before-issue-stale: 14
+          days-before-issue-close: 7
+          stale-issue-label: "stale"
+          stale-issue-message: "This issue is stale because it has been open for 14 days with no activity."
+          close-issue-message: "This issue was closed because it has been inactive for 7 days since being marked as stale."
+          any-of-issue-labels: "needinfo"
+          days-before-pr-stale: -1
+          days-before-pr-close: -1
+          repo-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/lint.yml

@@ -0,0 +1,18 @@
+name: Static analysis
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+        - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        - name: Run flake8
+          run: make lint

.github/workflows/rstcheck.yml

@@ -0,0 +1,18 @@
+name: Ensure RST is well-formed
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  rstcheck:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - name: Run rstcheck
+        run: make rstcheck

.github/workflows/typecheck.yml

@@ -0,0 +1,30 @@
+name: Type check
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - name: Set up Python
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: '3.12'
+      - name: Install build dependencies
+        run: |
+          sudo apt-get update
+          # For pocketsphinx (already installed: swig)
+          sudo apt-get install --no-install-recommends -y libpulse-dev libasound2-dev
+          # For PyAudio
+          sudo apt-get install --no-install-recommends -y portaudio19-dev
+      - name: Install Python dependencies
+        run: |
+          python -m pip install .[dev,audio,pocketsphinx,google-cloud,whisper-local,faster-whisper,openai,groq,vosk]
+      - run: make typecheck

.github/workflows/unittests.yml

@@ -0,0 +1,64 @@
+name: Unit tests
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  build:
+    strategy:
+      fail-fast: true
+      matrix:
+        include:
+          - os: ubuntu-latest
+            python-version: "3.9"
+          - os: ubuntu-latest
+            python-version: "3.10"
+          - os: ubuntu-latest
+            python-version: "3.11"
+          - os: ubuntu-latest
+            python-version: "3.12"
+          - os: ubuntu-latest
+            python-version: "3.13"
+          - os: ubuntu-latest
+            python-version: "3.14"
+          - os: windows-latest
+            python-version: "3.11"
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install build dependencies
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          sudo apt-get update
+          # For pocketsphinx (already installed: swig)
+          sudo apt-get install --no-install-recommends -y libpulse-dev libasound2-dev
+          # For PyAudio
+          sudo apt-get install --no-install-recommends -y portaudio19-dev
+      - name: Install ffmpeg (for Whisper)
+        uses: FedericoCarboni/setup-ffmpeg@37062fbf7149fc5578d6c57e08aed62458b375d6 # v3.1
+      - name: Install Python dependencies (Ubuntu, <=3.13)
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version != '3.14'
+        run: |
+          python -m pip install .[dev,audio,pocketsphinx,google-cloud,whisper-local,faster-whisper,openai,groq,vosk,cohere-api]
+      - name: Install Python dependencies (Ubuntu, 3.14)
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.14'
+        run: |
+          python -m pip install .[dev,audio,pocketsphinx,google-cloud,openai,groq,vosk,cohere-api]
+      - name: Install Python dependencies (Windows)
+        if: matrix.os == 'windows-latest'
+        run: |
+          python -m pip install .[dev,whisper-local,faster-whisper,google-cloud,openai,groq,vosk,cohere-api]
+      - name: Set up vosk model
+        run: python -m speech_recognition.cli download vosk
+      - name: Test with unittest
+        run: |
+          pytest --doctest-modules -s -v speech_recognition/recognizers/ tests/