PyPI - transcribe-cpp-native - Versions diffs - 0.2.4__tar.gz → 0.3.1__tar.gz - Mend

transcribe-cpp-native 0.2.4tar.gz → 0.3.1tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1529) hide show

transcribe_cpp_native-0.3.1/Cargo.lock ADDED Viewed

@@ -0,0 +1,394 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 3
+[[package]]
+name = "aho-corasick"
+version = "1.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ddd31a130427c27518df266943a5308ed92d4b226cc639f5a8f1002816174301"
+dependencies = [
+ "memchr",
+]
+[[package]]
+name = "bindgen"
+version = "0.72.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "993776b509cfb49c750f11b8f07a46fa23e0a1386ffc01fb1e7d343efc387895"
+dependencies = [
+ "bitflags",
+ "cexpr",
+ "clang-sys",
+ "itertools",
+ "log",
+ "prettyplease",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "rustc-hash",
+ "shlex 1.3.0",
+ "syn",
+]
+[[package]]
+name = "bitflags"
+version = "2.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b4388bee8683e3d04af747c73422af53102d2bd24d9eadb6cbc100baef4b43f8"
+[[package]]
+name = "cc"
+version = "1.2.64"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dad887fd958be91b5098c0248def011f4523ab786cd411be668777e55063501f"
+dependencies = [
+ "find-msvc-tools",
+ "shlex 2.0.1",
+]
+[[package]]
+name = "cexpr"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6fac387a98bb7c37292057cffc56d62ecb629900026402633ae9160df93a8766"
+dependencies = [
+ "nom",
+]
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+[[package]]
+name = "clang-sys"
+version = "1.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b023947811758c97c59bf9d1c188fd619ad4718dcaa767947df1cadb14f39f4"
+dependencies = [
+ "glob",
+ "libc",
+ "libloading",
+]
+[[package]]
+name = "cmake"
+version = "0.1.58"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c0f78a02292a74a88ac736019ab962ece0bc380e3f977bf72e376c5d78ff0678"
+dependencies = [
+ "cc",
+]
+[[package]]
+name = "cobs"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fa961b519f0b462e3a3b4a34b64d119eeaca1d59af726fe450bbba07a9fc0a1"
+dependencies = [
+ "thiserror",
+]
+[[package]]
+name = "either"
+version = "1.16.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "91622ff5e7162018101f2fea40d6ebf4a78bbe5a49736a2020649edf9693679e"
+[[package]]
+name = "embedded-io"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ef1a6892d9eef45c8fa6b9e0086428a2cca8491aca8f787c534a3d6d0bcb3ced"
+[[package]]
+name = "embedded-io"
+version = "0.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "edd0f118536f44f5ccd48bcb8b111bdc3de888b58c74639dfb034a357d0f206d"
+[[package]]
+name = "find-msvc-tools"
+version = "0.1.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5baebc0774151f905a1a2cc41989300b1e6fbb29aff0ceffa1064fdd3088d582"
+[[package]]
+name = "glob"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0cc23270f6e1808e30a928bdc84dea0b9b4136a8bc82338574f23baf47bbd280"
+[[package]]
+name = "hound"
+version = "3.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "62adaabb884c94955b19907d60019f4e145d091c75345379e70d1ee696f7854f"
+[[package]]
+name = "itertools"
+version = "0.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "413ee7dfc52ee1a4949ceeb7dbc8a33f2d6c088194d9f922fb8318faf1f01186"
+dependencies = [
+ "either",
+]
+[[package]]
+name = "itoa"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
+[[package]]
+name = "libc"
+version = "0.2.186"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
+[[package]]
+name = "libloading"
+version = "0.8.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d7c4b02199fee7c5d21a5ae7d8cfa79a6ef5bb2fc834d6e9058e89c825efdc55"
+dependencies = [
+ "cfg-if",
+ "windows-link",
+]
+[[package]]
+name = "log"
+version = "0.4.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "953f07c43838f8e6f9758cab68bf5bed85465e7587ebe0b823f1bcd81978ad3a"
+[[package]]
+name = "memchr"
+version = "2.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "88904434abc2901f197fe8cc55f0445e7ded921dba5911dad2e2b39b48e663c4"
+[[package]]
+name = "minimal-lexical"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68354c5c6bd36d73ff3feceb05efa59b6acb7626617f4962be322a825e61f79a"
+[[package]]
+name = "nom"
+version = "7.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d273983c5a657a70a3e8f2a01329822f3b8c8172b73826411a55751e404a0a4a"
+dependencies = [
+ "memchr",
+ "minimal-lexical",
+]
+[[package]]
+name = "postcard"
+version = "1.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6764c3b5dd454e283a30e6dfe78e9b31096d9e32036b5d1eaac7a6119ccb9a24"
+dependencies = [
+ "cobs",
+ "embedded-io 0.4.0",
+ "embedded-io 0.6.1",
+ "serde",
+]
+[[package]]
+name = "prettyplease"
+version = "0.2.37"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "479ca8adacdd7ce8f1fb39ce9ecccbfe93a3f1344b3d0d97f20bc0196208f62b"
+dependencies = [
+ "proc-macro2",
+ "syn",
+]
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+[[package]]
+name = "regex"
+version = "1.12.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f1292b7759ae1cb9ec195452d1390a074f0cd8541ab7a5a8c31cd6db45d4a6ba"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+[[package]]
+name = "regex-automata"
+version = "0.4.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6e1dd4122fc1595e8162618945476892eefca7b88c52820e74af6262213cae8f"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+[[package]]
+name = "regex-syntax"
+version = "0.8.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
+[[package]]
+name = "rustc-hash"
+version = "2.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94300abf3f1ae2e2b8ffb7b58043de3d399c73fa6f4b73826402a5c457614dbe"
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "serde_json"
+version = "1.0.150"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e8014e44b4736ed0538adeecded0fce2a272f22dc9578a7eb6b2d9993c74cfb9"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+[[package]]
+name = "shlex"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
+[[package]]
+name = "shlex"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8fadd59c855ef2080decdef8ff161eb6661b86933c9d82e5ba29dc602a55aba"
+[[package]]
+name = "syn"
+version = "2.0.117"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+[[package]]
+name = "thiserror"
+version = "2.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4288b5bcbc7920c07a1149a35cf9590a2aa808e0bc1eafaade0b80947865fbc4"
+dependencies = [
+ "thiserror-impl",
+]
+[[package]]
+name = "thiserror-impl"
+version = "2.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ebc4ee7f67670e9b64d05fa4253e753e016c6c95ff35b89b7941d6b856dec1d5"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "transcribe-cpp"
+version = "0.3.1"
+dependencies = [
+ "hound",
+ "log",
+ "postcard",
+ "serde",
+ "serde_json",
+ "thiserror",
+ "transcribe-cpp-sys",
+]
+[[package]]
+name = "transcribe-cpp-sys"
+version = "0.3.1"
+dependencies = [
+ "cmake",
+ "serde_json",
+]
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+[[package]]
+name = "xtask"
+version = "0.0.0"
+dependencies = [
+ "bindgen",
+]
+[[package]]
+name = "zmij"
+version = "1.0.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa"

transcribe_cpp_native-0.3.1/Cargo.toml ADDED Viewed

@@ -0,0 +1,91 @@
+# This Cargo.toml lives at the repo root on purpose, mirroring the root
+# pyproject.toml: the `transcribe-cpp-sys` crate must carry the whole C++ tree
+# (include/, src/, vendored ggml/, cmake/, CMakeLists.txt) so a `cargo build`
+# can compile libtranscribe from source on any machine, and a registry tarball
+# cannot reach outside its manifest's directory. The `include` whitelist below
+# is the same move and the same root cause as pyproject-at-root.
+#
+# The sys crate's Rust sources live under bindings/rust/sys/ (via the [lib]
+# `path` and `build` keys); the safe `transcribe-cpp` wrapper is the workspace
+# member at bindings/rust/. See notes/rust-bindings-plan.md.
+[package]
+name = "transcribe-cpp-sys"
+version = "0.3.1"
+edition = "2021"
+rust-version = "1.74"
+description = "Native FFI bindings for transcribe.cpp, a C/C++ speech-to-text library built on ggml"
+license = "MIT"
+readme = "bindings/rust/sys/README.md"
+repository = "https://github.com/handy-computer/transcribe.cpp"
+homepage = "https://github.com/handy-computer/transcribe.cpp"
+keywords = ["transcription", "speech", "asr", "stt", "ggml"]
+categories = ["multimedia::audio", "external-ffi-bindings"]
+links = "transcribe"
+build = "bindings/rust/sys/build.rs"
+# Allowlist (not a denylist): the crate tarball contains exactly these paths.
+# git-ignored trees (models/, build*/, target/, dumps are NOT ignored — see
+# below) are pruned by cargo's git file listing too, but the whitelist is the
+# load-bearing guarantee. dumps/ and reports/ are git-TRACKED, so only an
+# allowlist keeps them out. The `cargo package` audit gate (rust-ci.yml)
+# asserts ggml is present and models/dumps/reports are absent, plus the 10 MB
+# crates.io size cap. ggml/examples and ggml/tests are pruned (not needed to
+# build libggml) to keep weight down.
+include = [
+    "/CMakeLists.txt",
+    "/CMakePresets.json",
+    "/LICENSE",
+    "/include/**/*.h",
+    "/include/transcribe.abihash",
+    "/src/**",
+    "/cmake/**",
+    "/ggml/CMakeLists.txt",
+    "/ggml/cmake/**",
+    "/ggml/include/**",
+    "/ggml/src/**",
+    "/ggml/scripts/**",
+    "/ggml/LICENSE",
+    "/ggml/AUTHORS",
+    "/ggml/ggml.pc.in",
+    "/bindings/rust/sys/**",
+]
+[lib]
+name = "transcribe_cpp_sys"
+path = "bindings/rust/sys/src/lib.rs"
+[features]
+# Metal is the default backend on Apple targets; on every other target the
+# `metal` feature is a no-op (build.rs only forwards -DTRANSCRIBE_METAL=ON when
+# the host is Apple — non-Apple uses the CMake default, which is CPU). A pure
+# CPU build on macOS is `default-features = false`.
+default = ["metal"]
+metal = []
+vulkan = []
+cuda = []
+rocm = []
+openmp = []
+# `shared` links a shared libtranscribe (.so/.dylib/.dll) loaded at runtime
+# instead of statically baking it into the consumer binary. The default is a
+# self-contained static link. (Renamed from `dylib`.)
+shared = []
+# `dynamic-backends` additionally ships each compute backend (the per-ISA CPU
+# tiers, Vulkan, CUDA, ROCm, ...) as a loadable module next to the library, selected at
+# runtime by transcribe_init_backends(). Requires a shared library, so it implies
+# `shared`. See notes/rust-dynamic-backends-plan.md.
+dynamic-backends = ["shared"]
+[build-dependencies]
+cmake = "0.1"
+serde_json = "1"
+# The sys crate's manifest is THIS file (repo root) so the tarball can carry
+# the whole C++ tree; its Rust sources are the only non-package subtree under
+# bindings/rust/ (build.rs + src/ at bindings/rust/sys/). The two sibling
+# packages — the safe wrapper and the dev xtask — are workspace members. The
+# sys sources must NOT live inside a member's directory, or cargo would refuse
+# to package them with the root crate (a member owns its whole subtree).
+[workspace]
+resolver = "2"
+members = ["bindings/rust/transcribe-cpp", "bindings/rust/xtask"]

transcribe_cpp_native-0.3.1/PKG-INFO ADDED Viewed

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: transcribe-cpp-native
+Version: 0.3.1
+Summary: Prebuilt native library for transcribe-cpp (speech-to-text, ggml)
+Keywords: transcription,speech-to-text,asr,ggml,native
+Author: The transcribe.cpp authors
+License-Expression: MIT
+License-File: LICENSE
+License-File: ggml/LICENSE
+License-File: src/third_party/miniz/LICENSE
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Project-URL: Homepage, https://github.com/handy-computer/transcribe.cpp
+Project-URL: Repository, https://github.com/handy-computer/transcribe.cpp
+Project-URL: Issues, https://github.com/handy-computer/transcribe.cpp/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+# transcribe-cpp-native
+Prebuilt native library for [`transcribe-cpp`](https://pypi.org/project/transcribe-cpp/),
+the Python bindings for [transcribe.cpp](https://github.com/handy-computer/transcribe.cpp)
+(local speech-to-text on ggml).
+You normally don't install this directly — `pip install transcribe-cpp`
+depends on it. It carries no Python API; it bundles the `libtranscribe`
+shared library plus its ggml backend libraries and registers them with the
+bindings via the `transcribe_cpp.native` entry point.
+What each artifact ships:
+| Artifact | Backends |
+| --- | --- |
+| Linux x86_64 wheel | CPU (conservative baseline) + Vulkan backend module |
+| Windows x86_64 wheel | CPU (conservative baseline) + Vulkan backend module |
+| macOS arm64 wheel | Metal (embedded shaders) + CPU |
+| sdist | builds from source; machine-tuned CPU by default, backends via `CMAKE_ARGS` |
+The Vulkan backend ships as a dynamic ggml module: on machines without a
+Vulkan loader or driver it simply fails to load and CPU keeps working — no
+crash, no import error. Specialized providers (e.g. CUDA) are separate
+packages installed alongside this one via extras of `transcribe-cpp`.
+Building from the sdist requires CMake ≥ 3.21, Ninja, and a C++17 compiler;
+backend selection follows the repo's CMake options, e.g.:
+```sh
+CMAKE_ARGS="-DTRANSCRIBE_VULKAN=ON" pip install --no-binary :all: transcribe-cpp-native
+```

transcribe_cpp_native-0.3.1/bindings/python/README.md ADDED Viewed

@@ -0,0 +1,128 @@
+# transcribe-cpp
+Python bindings for [transcribe.cpp](https://github.com/handy-computer/transcribe.cpp),
+a C/C++ speech-to-text library built on ggml.
+> **Status: in development.** Until wheels are published, use a locally built
+> `libtranscribe` through repo auto-discovery or `TRANSCRIBE_LIBRARY`.
+Upgrading from 0.1? See the
+[0.2 migration guide](https://github.com/handy-computer/transcribe.cpp/blob/main/docs/migrating-to-0.2.md),
+including the replacement of `gpu_device=` with exact device objects.
+```python
+import transcribe_cpp
+with transcribe_cpp.Model("model.gguf") as model:
+    with model.session() as session:
+        result = session.run(pcm_float32_16k_mono)
+        print(result.text)
+```
+`run()` takes mono 16 kHz float32 PCM (buffer-protocol object or sequence). It
+does not decode containers or resample; convert audio before calling it.
+```python
+import numpy as np
+pcm = np.asarray(audio, dtype=np.float32)   # 1-D, 16 kHz mono
+# Downmix stereo first; 2-D input is rejected:
+# pcm = audio.mean(axis=1).astype(np.float32)
+result = session.run(pcm)
+```
+### Punctuation, capitalization, and text normalization
+Generic run controls use `"default"` to preserve each model family's shipped
+behavior. Models advertising `model.supports("pnc")` accept `pnc="off"` or
+`pnc="on"`; models advertising `model.supports("itn")` accept the equivalent
+`itn` values. The options are available on `run()`, `run_batch()`, `stream()`,
+and the one-shot `transcribe()` helper.
+```python
+result = session.run(pcm, pnc="off", itn="on")
+```
+### Prompting
+`vocabulary` (custom terms), `prompt` (context, or the instruction under
+`task="instruct"`) and `prefix` (text the model continues from) take effect
+where `model.supports()` reports `"vocabulary"`, `"context_prompt"`,
+`"instruct"` or `"transcript_prefix"`.
+```python
+result = session.run(pcm, vocabulary=["Kubernetes", "gRPC"])
+```
+Streaming models expose incremental transcription with committed/tentative
+text views — see `examples/stream_wav.py`:
+```python
+with model.session() as session, session.stream() as stream:
+    for chunk in pcm_chunks:
+        stream.feed(chunk)
+        text = stream.text()        # .committed (stable) + .tentative
+    stream.finalize()
+    result = stream.snapshot()      # language, segments, words, tokens, timings
+```
+Long transcriptions can be cancelled from another thread with
+`session.cancel()` — the run raises `Aborted` with the partial transcript on
+`exc.partial_result` (same for `OutputTruncated`).
+## Backends
+`Model(backend=...)` applies a backend policy (`"auto"` uses the best
+available). `transcribe_cpp.backends()` returns process-local device objects;
+pass one as `Model(device=device)` for exact selection with no fallback. Persist
+a device's `device_id`, not its runtime handle or index. `backend_available(kind)`
+checks whether a backend policy can currently be satisfied.
+```python
+device = next(d for d in transcribe_cpp.backends() if d.device_type == "cpu")
+with transcribe_cpp.Model("model.gguf", device=device) as model:
+    print(model.device)
+```
+| Variable | Effect |
+|---|---|
+| `TRANSCRIBE_BACKEND` | overrides the `"auto"` default; explicit `backend=` still wins |
+| `TRANSCRIBE_NATIVE_PROVIDER` | forces an installed native provider package, for example `cu12` |
+| `TRANSCRIBE_LIBRARY` | loads exactly this shared library |
+Planned wheels will bundle CPU plus platform accelerators;
+`transcribe-cpp[cu12]` will add the CUDA 12 provider.
+## Running from a working tree
+The binding loads the native library at import and verifies its ABI layout and
+version before use. Build a shared library, then run from the repo or point
+`TRANSCRIBE_LIBRARY` at it:
+```bash
+cmake -B build-shared -DTRANSCRIBE_BUILD_SHARED=ON
+cmake --build build-shared --target transcribe
+cd bindings/python
+PYTHONPATH=src uv run --no-project python examples/transcribe_wav.py \
+    ../../models/whisper-tiny.en/whisper-tiny.en-Q5_K_M.gguf ../../samples/jfk.wav
+```
+No-model tests always run; model tests skip unless smoke assets are present.
+Override paths with `TRANSCRIBE_SMOKE_MODEL`, `TRANSCRIBE_SMOKE_AUDIO`, and
+`TRANSCRIBE_SMOKE_STREAMING_MODEL`.
+```bash
+cd bindings/python
+TRANSCRIBE_LIBRARY=../../build-shared/src/libtranscribe.dylib \
+    uv run --extra test pytest
+```
+## Notes
+- One run/stream at a time per `Model` in 0.x: sessions share the model's
+  compute backend, so serialize runs across sessions (or load one model per
+  worker). See the `Model` docstring.
+- Import package: `transcribe_cpp`
+- Distribution: `transcribe-cpp`
+- License: MIT

transcribe-cpp-native 0.2.4__tar.gz → 0.3.1__tar.gz

transcribe-cpp-native 0.2.4tar.gz → 0.3.1tar.gz