crispasr 0.8.22__tar.gz

crispasr-0.8.22/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023-2026 The ggml authors
+
+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.

crispasr-0.8.22/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: crispasr
+Version: 0.8.22
+Summary: Lightweight on-device speech recognition via ggml — Python bindings for CrispASR (Whisper, Qwen3-ASR, FastConformer, Canary, Parakeet, Cohere, Granite, Voxtral, wav2vec2, and more).
+Author: CrispASR contributors
+License: MIT License
+        
+        Copyright (c) 2023-2026 The ggml authors
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/CrispStrobe/CrispASR
+Project-URL: Repository, https://github.com/CrispStrobe/CrispASR
+Project-URL: Issues, https://github.com/CrispStrobe/CrispASR/issues
+Project-URL: Changelog, https://github.com/CrispStrobe/CrispASR/blob/main/HISTORY.md
+Keywords: asr,speech-recognition,whisper,ggml,speech-to-text,transcription
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.20
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Dynamic: license-file
+
+# crispasr
+
+Python bindings for [CrispASR](https://github.com/CrispStrobe/CrispASR) — lightweight on-device speech recognition via ggml.
+
+Supports 17 ASR backends including Whisper, Qwen3-ASR, FastConformer, Canary, Parakeet, Cohere, Granite-Speech, Voxtral, wav2vec2, GLM-ASR, Kyutai-STT, Moonshine, FireRed, OmniASR, and VibeVoice-ASR.
+
+## Install
+
+```bash
+pip install crispasr
+```
+
+This wheel is **pure Python** and does **not** bundle the native library — install `libcrispasr` separately, the same way `crispasr`'s Python bindings work:
+
+**macOS**
+```bash
+brew install crispasr        # once published; until then build from source
+```
+
+**Linux / Windows / from source**
+```bash
+git clone https://github.com/CrispStrobe/CrispASR
+cd CrispASR
+cmake -B build && cmake --build build -j
+sudo cmake --install build   # installs libcrispasr.{so,dylib,dll}
+```
+
+If `libcrispasr` is in a non-standard location, set `CRISPASR_LIB_PATH`:
+
+```bash
+export CRISPASR_LIB_PATH=/path/to/libcrispasr.so
+```
+
+## Quick start
+
+```python
+from crispasr import CrispASR
+
+model = CrispASR("ggml-base.en.bin")
+for seg in model.transcribe("audio.wav"):
+    print(f"[{seg.start:.1f}s - {seg.end:.1f}s] {seg.text}")
+model.close()
+```
+
+Or use the unified `Session` API for non-Whisper backends (Qwen3-ASR, FastConformer, Parakeet, …):
+
+```python
+from crispasr import Session
+
+s = Session("qwen3-asr-0.6b-q4_k.gguf")
+for seg in s.transcribe_pcm(pcm_f32, sample_rate=16000):
+    print(seg.text)
+```
+
+## API
+
+- `CrispASR` — Whisper-compatible high-level API
+- `Session` — unified API across all 17 backends
+- `align_words(...)` — word-level CTC alignment
+- `diarize_segments(...)` — speaker diarization (energy / xcorr / vad-turns / pyannote)
+- `SpeakerEmbedder(spec)` — pluggable embedder ("auto"/"titanet", "indextts"/"ecapa", or a `.gguf` path)
+- `PyannoteCache(pcm, model)` — pre-computed pyannote-seg posteriors for cross-slice consistency
+- `agglomerative_cluster(embeddings, ...)` — single-linkage cosine clustering for globally stable speaker IDs
+- `TitaNet` / `SpeakerDB` — standalone speaker verification + closed-roster profile matching (consent-gated; requires `expected_names` + `consent=True`, see docs/diarization-speakers.md)
+- `detect_language_pcm(...)` — language ID
+- `registry_lookup(...)` — auto-download known models from the model hub
+- `registry_default_bundle(...)` — enumerate the exact primary, companion, and extra files used by `-m auto`, including licence-acceptance policy
+
+See the [main repo](https://github.com/CrispStrobe/CrispASR) for full documentation, model registry, and CLI.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

crispasr-0.8.22/README.md

@@ -0,0 +1,73 @@
+# crispasr
+
+Python bindings for [CrispASR](https://github.com/CrispStrobe/CrispASR) — lightweight on-device speech recognition via ggml.
+
+Supports 17 ASR backends including Whisper, Qwen3-ASR, FastConformer, Canary, Parakeet, Cohere, Granite-Speech, Voxtral, wav2vec2, GLM-ASR, Kyutai-STT, Moonshine, FireRed, OmniASR, and VibeVoice-ASR.
+
+## Install
+
+```bash
+pip install crispasr
+```
+
+This wheel is **pure Python** and does **not** bundle the native library — install `libcrispasr` separately, the same way `crispasr`'s Python bindings work:
+
+**macOS**
+```bash
+brew install crispasr        # once published; until then build from source
+```
+
+**Linux / Windows / from source**
+```bash
+git clone https://github.com/CrispStrobe/CrispASR
+cd CrispASR
+cmake -B build && cmake --build build -j
+sudo cmake --install build   # installs libcrispasr.{so,dylib,dll}
+```
+
+If `libcrispasr` is in a non-standard location, set `CRISPASR_LIB_PATH`:
+
+```bash
+export CRISPASR_LIB_PATH=/path/to/libcrispasr.so
+```
+
+## Quick start
+
+```python
+from crispasr import CrispASR
+
+model = CrispASR("ggml-base.en.bin")
+for seg in model.transcribe("audio.wav"):
+    print(f"[{seg.start:.1f}s - {seg.end:.1f}s] {seg.text}")
+model.close()
+```
+
+Or use the unified `Session` API for non-Whisper backends (Qwen3-ASR, FastConformer, Parakeet, …):
+
+```python
+from crispasr import Session
+
+s = Session("qwen3-asr-0.6b-q4_k.gguf")
+for seg in s.transcribe_pcm(pcm_f32, sample_rate=16000):
+    print(seg.text)
+```
+
+## API
+
+- `CrispASR` — Whisper-compatible high-level API
+- `Session` — unified API across all 17 backends
+- `align_words(...)` — word-level CTC alignment
+- `diarize_segments(...)` — speaker diarization (energy / xcorr / vad-turns / pyannote)
+- `SpeakerEmbedder(spec)` — pluggable embedder ("auto"/"titanet", "indextts"/"ecapa", or a `.gguf` path)
+- `PyannoteCache(pcm, model)` — pre-computed pyannote-seg posteriors for cross-slice consistency
+- `agglomerative_cluster(embeddings, ...)` — single-linkage cosine clustering for globally stable speaker IDs
+- `TitaNet` / `SpeakerDB` — standalone speaker verification + closed-roster profile matching (consent-gated; requires `expected_names` + `consent=True`, see docs/diarization-speakers.md)
+- `detect_language_pcm(...)` — language ID
+- `registry_lookup(...)` — auto-download known models from the model hub
+- `registry_default_bundle(...)` — enumerate the exact primary, companion, and extra files used by `-m auto`, including licence-acceptance policy
+
+See the [main repo](https://github.com/CrispStrobe/CrispASR) for full documentation, model registry, and CLI.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

crispasr-0.8.22/crispasr/__init__.py

@@ -0,0 +1,74 @@
+"""CrispASR — lightweight speech recognition via ggml."""
+
+from ._binding import (
+    AlignedWord,
+    CrispASR,
+    DiarizeMethod,
+    DiarizeSegment,
+    KokoroResolved,
+    LidMethod,
+    LidResult,
+    Mic,
+    PyannoteCache,
+    RegistryArtifact,
+    RegistryBundle,
+    RegistryEntry,
+    Segment,
+    Session,
+    SessionSegment,
+    SessionWord,
+    SpeakerDB,
+    SpeakerEmbedder,
+    agglomerative_cluster,
+    align_words,
+    cache_dir,
+    cache_ensure_file,
+    detect_language_pcm,
+    diarize_segments,
+    kokoro_resolve_for_lang,
+    list_known_models,
+    mic_default_device_name,
+    registry_lookup,
+    registry_lookup_by_filename,
+    registry_default_bundle,
+    watermark_detect,
+    watermark_embed,
+    watermark_load_model,
+)
+
+__all__ = [
+    "AlignedWord",
+    "CrispASR",
+    "DiarizeMethod",
+    "DiarizeSegment",
+    "KokoroResolved",
+    "LidMethod",
+    "LidResult",
+    "Mic",
+    "PyannoteCache",
+    "RegistryArtifact",
+    "RegistryBundle",
+    "RegistryEntry",
+    "Segment",
+    "Session",
+    "SessionSegment",
+    "SessionWord",
+    "SpeakerDB",
+    "SpeakerEmbedder",
+    "agglomerative_cluster",
+    "align_words",
+    "cache_dir",
+    "cache_ensure_file",
+    "detect_language_pcm",
+    "diarize_segments",
+    "kokoro_resolve_for_lang",
+    "list_known_models",
+    "mic_default_device_name",
+    "registry_lookup",
+    "registry_lookup_by_filename",
+    "registry_default_bundle",
+    "watermark_detect",
+    "watermark_embed",
+    "watermark_load_model",
+]
+__version__ = "0.8.22"