paraspeakrs 0.2.0__tar.gz

paraspeakrs-0.2.0/.gitignore

@@ -0,0 +1,21 @@
+.pytest_cache/
+__pycache__/
+*.py[cod]
+.venv/
+
+models/
+checkpoints/
+
+var/
+test-audio
+result
+out
+out_lavasr
+out-clearvoice
+deefilter_out
+deepfilter_out
+.code-review-graph
+.vscode/PythonImportHelper-v2-Completion.json
+
+dist/
+packages/speakrs-diar/dist/

paraspeakrs-0.2.0/CHANGELOG.md

@@ -0,0 +1,59 @@
+# Changelog
+
+All notable changes to `paraspeakrs` are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions follow
+[Semantic Versioning](https://semver.org/).
+
+## [0.2.0] — 2026-09-18
+
+Installable as a tool: `uv tool install paraspeakrs`.
+
+### Changed
+
+- **Renamed** from `parakeet-int8-pyannote-service` to `paraspeakrs`, and the import
+  package from `parakeet_int8_pyannote_service` to `paraspeakrs`. The name now covers both
+  halves of the pipeline — Parakeet for ASR, speakrs for diarization — rather than naming
+  pyannote, which the project stopped depending on when speakrs became the default backend.
+- **One command instead of three.** `parakeet-service`, `parakeet-tui` and `parakeet-mcp`
+  are replaced by `paraspeakrs` with `run`, `serve`, `label-dir`, `tui`, `mcp` and
+  `fetch-models` subcommands. The `tui` and `mcp` imports stay lazy so the core install
+  does not need their extras.
+- **The ASR model and diarizer binary no longer default to paths relative to the working
+  directory.** Both defaulted into the checkout (`models/…`, `packages/speakrs-diar/…`),
+  so the tool only worked when launched from the repository root. The model now defaults
+  under the workspace directory, and the binary is looked up next to the interpreter, then
+  on `PATH`, then in a checkout — so a source checkout keeps working unchanged.
+- `label-dir` now requires its directory argument. It used to default to `test-audio`,
+  which only means something inside the repository.
+- Environment variable names are unchanged; existing `PARAKEET_*` and `SPEAKRS_*` setups
+  keep working, as does the workspace at
+  `~/.local/share/fast-speaker-aware-meeting-transcriber`.
+
+### Added
+
+- **The ASR model downloads itself on first run** (~490 MB, from the sherpa-onnx GitHub
+  release — no Hugging Face account or token). `paraspeakrs fetch-models` pre-seeds it;
+  `PARAKEET_AUTO_DOWNLOAD=0` disables the implicit fetch. Downloads stage through a
+  temporary directory and are renamed into place, so an interrupted fetch cannot leave
+  behind something that looks like a working model.
+- `PARAKEET_MODEL_URL` points the download at a mirror or internal proxy.
+- Failures to obtain the model now explain the three ways around it — mirror, sideload,
+  or the OpenAI-compatible backend, which needs no local model at all.
+- `paraspeakrs-speakrs`, a companion wheel carrying the speakrs diarization binary for
+  macOS arm64, so the default backend works without Rust, cargo or Homebrew. The binary
+  is built with `--features coreml,blas-static` and its gfortran runtime is vendored into
+  the wheel, so it depends only on macOS system frameworks.
+- `paraspeakrs --version`.
+- Packaging metadata for publication: license, authors, classifiers, project URLs, and a
+  tag-triggered PyPI workflow using trusted publishing.
+
+### Fixed
+
+- `rich` is imported by the TUI but was never declared as a dependency; it arrived only as
+  a transitive dependency of `textual`. It is now declared in the `tui` extra.
+- `soundfile` was a required dependency but is imported nowhere in the package. Removed.
+- `sherpa-onnx` was declared both as a core dependency and in an `asr` extra, with
+  different version floors, while every documented command passed `--extra asr`. The extra
+  is gone; the core dependency stands.
+- `__version__` was hard-coded and had drifted behind the packaged version. It now reads
+  the installed distribution metadata.

paraspeakrs-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Albert Groothedde
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.