pipecat-local-stt-server 0.1.0__tar.gz

pipecat_local_stt_server-0.1.0/.claude/scheduled_tasks.lock

@@ -0,0 +1 @@
+{"sessionId":"f5d743f9-0d02-4b4f-98b2-1a9f822d588d","pid":48976,"procStart":"Sat May 30 03:52:09 2026","acquiredAt":1780119246008}

pipecat_local_stt_server-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,56 @@
+name: test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  # Base + backend extras. The MLX/Parakeet wheels are macOS/Apple-Silicon
+  # only, so the full-extras job runs on macos-14 (Apple Silicon runners).
+  test-macos:
+    runs-on: macos-14
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+      - name: Sync (base + mlx + parakeet)
+        run: uv sync --extra mlx --extra parakeet
+      - name: Protocol version gate
+        run: |
+          uv run python -c "from stt_server import protocol; assert protocol.PROTOCOL_VERSION == '0.1', protocol.PROTOCOL_VERSION; print('PROTOCOL_VERSION OK:', protocol.PROTOCOL_VERSION)"
+      - name: Run tests
+        run: uv run pytest -x
+
+  # Client-only install on Linux, to prove the base package (no MLX/Parakeet)
+  # resolves and the protocol/client/server surface tests pass without the
+  # Apple-Silicon-only backends. Backend-specific tests are skipped here.
+  test-linux-client:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+      - name: Sync (client only)
+        run: uv sync --extra client
+      - name: Protocol version gate
+        run: |
+          uv run python -c "from stt_server import protocol; assert protocol.PROTOCOL_VERSION == '0.1', protocol.PROTOCOL_VERSION; print('PROTOCOL_VERSION OK:', protocol.PROTOCOL_VERSION)"
+      - name: Run protocol/server/client tests (skip backend-weight tests)
+        run: |
+          uv run pytest -x \
+            tests/test_stt_server.py \
+            tests/test_protocol_version.py \
+            tests/test_backend_protocol.py \
+            tests/test_wire_schema_compat.py \
+            tests/test_env_helpers.py \
+            tests/test_stt_post_filter.py \
+            tests/test_render_stt_plist.py

pipecat_local_stt_server-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+
+# uv / virtualenv
+.venv/
+
+# OS
+.DS_Store

pipecat_local_stt_server-0.1.0/CHANGELOG.md

@@ -0,0 +1,81 @@
+# Changelog
+
+All notable changes to `pipecat-local-stt-server` are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Changed
+
+- **`env_float_first` / `env_int_first` now resolve by presence, not
+  non-emptiness** — matching `env_bool_first`. A present-but-empty canonical
+  `PIPECAT_STT_*` value now wins and resolves to the default, instead of
+  silently falling through to a set legacy `KODA_*` alias. This makes the
+  canonical-first precedence rule uniform across bool/float/int knobs. Parsing
+  is delegated to `env_float` / `env_int` so coercion is single-sourced.
+  Affects the `PIPECAT_STT_WHISPER_*` decode and degenerate-detection knobs.
+
+### Internal
+
+- `scripts/render_stt_plist.py` now imports `env_first` from `stt_server.env`
+  instead of carrying a duplicate `_env_first`; the resolver is single-sourced.
+- `stt_server/text_quality.py` resolves its thresholds through
+  `env_float_first` / `env_int_first` (gaining the invalid-value warning that
+  the prior inline parse swallowed) instead of `env_first` + inline `float()`.
+
+## [0.1.0] - 2026-05-30
+
+First public release: a standalone local WebSocket transcription (STT) server,
+client, and pluggable ASR backends, extracted (history-preserving) from the
+private `koda-pipecat` monorepo. Distribution name `pipecat-local-stt-server`,
+import name `stt_server`.
+
+### Added
+
+- **`PIPECAT_STT_*` environment-variable namespace** as the canonical
+  configuration surface, resolved canonical-first (the `PIPECAT_STT_*` name
+  wins when set):
+  - `PIPECAT_STT_AUTH_TOKEN` — server-side bearer for the serve path.
+  - `PIPECAT_STT_LABEL`, `PIPECAT_STT_SOCKET`, `PIPECAT_STT_BACKEND`,
+    `PIPECAT_STT_MODEL`, `PIPECAT_STT_LOG_DIR` — LaunchAgent install /
+    plist-render parameters (`scripts/install_stt_agent.sh`,
+    `scripts/render_stt_plist.py`, `scripts/mlx_teardown_spike.sh`).
+  - `PIPECAT_STT_WHISPER_CONDITION_ON_PREVIOUS_TEXT`,
+    `PIPECAT_STT_WHISPER_COMPRESSION_RATIO_THRESHOLD`,
+    `PIPECAT_STT_WHISPER_LOGPROB_THRESHOLD`,
+    `PIPECAT_STT_WHISPER_NO_SPEECH_THRESHOLD` — MLX Whisper decode /
+    hallucination-suppression knobs.
+  - `PIPECAT_STT_WHISPER_DEGENERATE_TOKEN_RATIO`,
+    `PIPECAT_STT_WHISPER_DEGENERATE_MIN_TOKENS` — degenerate-output filter
+    thresholds.
+- `env_bool_first` / `env_float_first` / `env_int_first` helpers in
+  `stt_server/env.py` for canonical-then-alias resolution.
+- PyPI packaging metadata: authors, `[project.urls]` (Homepage / Repository /
+  Issues), trove classifiers (BSD-2-Clause, Python 3.12 / 3.13, macOS,
+  speech / AI topics), and keywords.
+- `stt_server/examples/pipecat_stt_service.py` — a runnable Pipecat
+  `SegmentedSTTService` subclass (`LocalWebSocketSTTService`) wiring
+  `TranscriptionClient` into a pipeline, plus README sections on choosing a
+  backend/model (Whisper + Parakeet) and the Pipecat integration. The example
+  imports `pipecat`, which remains an optional, non-declared dependency.
+
+### Deprecated
+
+- All `KODA_STT_*` environment-variable names (and the
+  `KODA_TEXT_QUALITY_DEGENERATE_*` names) are **deprecated but still honoured**
+  as backward-compatible aliases. Precedence is canonical-first: a
+  `PIPECAT_STT_*` name wins when set, otherwise the legacy `KODA_*` name is
+  used. No existing `KODA_STT_*` deployment breaks. New deployments should
+  prefer the `PIPECAT_STT_*` names; the aliases may be removed in a future
+  major release.
+
+### Notes
+
+- `STT_WS_TOKEN` (the client-side / probe bearer) is unchanged and remains
+  strictly separate from the server-side `PIPECAT_STT_AUTH_TOKEN`.
+- Wire protocol is unchanged: `PROTOCOL_VERSION == "0.1"`; the `server.hello`
+  and `server.status` shapes are stable.
+
+[0.1.0]: https://github.com/vr000m/pipecat-local-stt-server/releases/tag/v0.1.0

pipecat_local_stt_server-0.1.0/LICENSE

@@ -0,0 +1,24 @@
+BSD 2-Clause License
+
+Copyright (c) 2026, Varun Singh
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.