clear-record 0.1.1__tar.gz

clear_record-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zhao Wen Yuan
+
+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.

clear_record-0.1.1/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: clear-record
+Version: 0.1.1
+Summary: Local-first multitrack transcription and record reconstruction: from many recordings to one clear record.
+Keywords: cli,transcription,audio,speech-to-text,asr,pipeline,reconciliation,signal-processing,alignment,whisper,cuda,rocm,metal,backend
+Author: zhaoweny
+Author-email: zhaoweny <zhaoweny@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing
+Classifier: Environment :: Console
+Classifier: Topic :: Utilities
+Requires-Dist: numpy>=2.0
+Requires-Dist: soundfile>=0.12
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/zhaoweny/clear-record
+Project-URL: Repository, https://github.com/zhaoweny/clear-record
+Project-URL: Issues, https://github.com/zhaoweny/clear-record/issues
+Provides-Extra: all
+Provides-Extra: amd
+Provides-Extra: apple
+Provides-Extra: nvidia
+Description-Content-Type: text/markdown
+
+# clear-record
+
+**Local-first multitrack transcription and record reconstruction:** ingest several
+recordings of one event, align them onto a common timebase, transcribe them
+locally, and reconcile **one clear, attributed record** — *from many recordings to
+one clear record*.
+
+Entirely offline after a one-time model download: no cloud, no telemetry, no
+account.
+
+```sh
+# from PyPI
+uvx clear-record --help           # run it without installing
+uv tool install clear-record      # or: pipx install clear-record
+
+# from a source checkout
+uv sync --all-packages --extra apple
+uv run --all-packages --extra apple clear-record --help
+```
+
+## The pipeline
+
+One subcommand per stage; `run` chains them:
+
+```sh
+clear-record ingest       # discover/declare the audio sources
+clear-record align        # place every source on a common clock (cross-correlation)
+clear-record transcribe   # run a local ASR backend (apple / nvidia / amd)
+clear-record reconcile    # merge into one attributed, aligned timeline
+clear-record export       # Markdown / SRT / VTT / JSON
+clear-record run          # ingest -> align -> transcribe -> reconcile -> export
+clear-record calibrate    # run it and report transcript quality against a reference
+```
+
+## Backends
+
+All three drive the **system `whisper-cli`** plus a ggml plugin, so the default
+install depends only on `numpy` and `soundfile` and never pulls a GPU framework;
+the `apple` / `nvidia` / `amd` extras are **no-op markers** (ADR-0005).
+`clear-record backends` reports what the current machine can actually run.
+
+## How it is packaged
+
+`clear-record` is a **single published distribution**: one import package,
+`clear_record`, with four internal layers as subpackages —
+
+| Layer | Contents |
+|---|---|
+| `clear_record.core` | backend-agnostic domain model (no third-party deps) |
+| `clear_record.engine` | audio I/O, cross-correlation alignment, reconcile (numpy + soundfile) |
+| `clear_record.providers` | per-vendor ASR backend adapters (apple / nvidia / amd) |
+| `clear_record.cli` | the `clear-record` command implementation |
+
+The layers are **not** separate distributions — the subpackages hide them behind
+one install name while the import layering (and the vendor-free core) stays
+enforced by a test (ADR-0012, ADR-0004). The console script targets
+`clear_record.cli:main` directly, so `import clear_record` stays light.
+
+**Code** is [MIT](https://github.com/zhaoweny/clear-record/blob/main/LICENSE); the
+license boundary — including how copyleft is consumed over process/network
+boundaries — is
+[ADR-0003](https://github.com/zhaoweny/clear-record/blob/main/docs/adr/0003-license-boundary.md).
+See the [repository README](https://github.com/zhaoweny/clear-record#readme) for
+the full story.

clear_record-0.1.1/README.md

@@ -0,0 +1,64 @@
+# clear-record
+
+**Local-first multitrack transcription and record reconstruction:** ingest several
+recordings of one event, align them onto a common timebase, transcribe them
+locally, and reconcile **one clear, attributed record** — *from many recordings to
+one clear record*.
+
+Entirely offline after a one-time model download: no cloud, no telemetry, no
+account.
+
+```sh
+# from PyPI
+uvx clear-record --help           # run it without installing
+uv tool install clear-record      # or: pipx install clear-record
+
+# from a source checkout
+uv sync --all-packages --extra apple
+uv run --all-packages --extra apple clear-record --help
+```
+
+## The pipeline
+
+One subcommand per stage; `run` chains them:
+
+```sh
+clear-record ingest       # discover/declare the audio sources
+clear-record align        # place every source on a common clock (cross-correlation)
+clear-record transcribe   # run a local ASR backend (apple / nvidia / amd)
+clear-record reconcile    # merge into one attributed, aligned timeline
+clear-record export       # Markdown / SRT / VTT / JSON
+clear-record run          # ingest -> align -> transcribe -> reconcile -> export
+clear-record calibrate    # run it and report transcript quality against a reference
+```
+
+## Backends
+
+All three drive the **system `whisper-cli`** plus a ggml plugin, so the default
+install depends only on `numpy` and `soundfile` and never pulls a GPU framework;
+the `apple` / `nvidia` / `amd` extras are **no-op markers** (ADR-0005).
+`clear-record backends` reports what the current machine can actually run.
+
+## How it is packaged
+
+`clear-record` is a **single published distribution**: one import package,
+`clear_record`, with four internal layers as subpackages —
+
+| Layer | Contents |
+|---|---|
+| `clear_record.core` | backend-agnostic domain model (no third-party deps) |
+| `clear_record.engine` | audio I/O, cross-correlation alignment, reconcile (numpy + soundfile) |
+| `clear_record.providers` | per-vendor ASR backend adapters (apple / nvidia / amd) |
+| `clear_record.cli` | the `clear-record` command implementation |
+
+The layers are **not** separate distributions — the subpackages hide them behind
+one install name while the import layering (and the vendor-free core) stays
+enforced by a test (ADR-0012, ADR-0004). The console script targets
+`clear_record.cli:main` directly, so `import clear_record` stays light.
+
+**Code** is [MIT](https://github.com/zhaoweny/clear-record/blob/main/LICENSE); the
+license boundary — including how copyleft is consumed over process/network
+boundaries — is
+[ADR-0003](https://github.com/zhaoweny/clear-record/blob/main/docs/adr/0003-license-boundary.md).
+See the [repository README](https://github.com/zhaoweny/clear-record#readme) for
+the full story.

clear_record-0.1.1/pyproject.toml

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["uv_build>=0.12.0,<0.13.0"]
+build-backend = "uv_build"
+
+[project]
+name = "clear-record"
+version = "0.1.1"
+description = "Local-first multitrack transcription and record reconstruction: from many recordings to one clear record."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "cli",
+    "transcription",
+    "audio",
+    "speech-to-text",
+    "asr",
+    "pipeline",
+    "reconciliation",
+    "signal-processing",
+    "alignment",
+    "whisper",
+    "cuda",
+    "rocm",
+    "metal",
+    "backend",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+    "Topic :: Multimedia :: Sound/Audio :: Analysis",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing",
+    "Environment :: Console",
+    "Topic :: Utilities",
+]
+requires-python = ">=3.12"
+dependencies = [
+    "numpy>=2.0",
+    "soundfile>=0.12",
+]
+
+[[project.authors]]
+name = "zhaoweny"
+email = "zhaoweny@users.noreply.github.com"
+
+[project.urls]
+Homepage = "https://github.com/zhaoweny/clear-record"
+Repository = "https://github.com/zhaoweny/clear-record"
+Issues = "https://github.com/zhaoweny/clear-record/issues"
+
+[project.optional-dependencies]
+apple = []
+nvidia = []
+amd = []
+all = []
+
+[project.scripts]
+clear-record = "clear_record.cli:main"

clear_record-0.1.1/pyproject.toml.orig

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["uv_build>=0.12.0,<0.13.0"]
+build-backend = "uv_build"
+
+[project]
+name = "clear-record"
+version = "0.1.1"
+description = "Local-first multitrack transcription and record reconstruction: from many recordings to one clear record."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "zhaoweny", email = "zhaoweny@users.noreply.github.com" }]
+keywords = [
+    "cli",
+    "transcription",
+    "audio",
+    "speech-to-text",
+    "asr",
+    "pipeline",
+    "reconciliation",
+    "signal-processing",
+    "alignment",
+    "whisper",
+    "cuda",
+    "rocm",
+    "metal",
+    "backend",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+    "Topic :: Multimedia :: Sound/Audio :: Analysis",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing",
+    "Environment :: Console",
+    "Topic :: Utilities",
+]
+requires-python = ">=3.12"
+dependencies = [
+    "numpy>=2.0",
+    "soundfile>=0.12",
+]
+
+[project.urls]
+Homepage = "https://github.com/zhaoweny/clear-record"
+Repository = "https://github.com/zhaoweny/clear-record"
+Issues = "https://github.com/zhaoweny/clear-record/issues"
+
+# Backend extras are no-op markers (every path uses the system `whisper-cli` +
+# a ggml plugin); they exist so `--extra <backend>` stays a valid switch. See
+# ADR-0005.
+[project.optional-dependencies]
+apple = []
+nvidia = []
+amd = []
+all = []
+
+[project.scripts]
+clear-record = "clear_record.cli:main"

clear_record-0.1.1/src/clear_record/__init__.py

@@ -0,0 +1,15 @@
+"""clear-record: a local-first multitrack transcription and record-reconstruction tool.
+
+The published distribution is a single package with four internal layers:
+
+- :mod:`clear_record.core` — backend-agnostic domain model (no third-party deps);
+- :mod:`clear_record.engine` — audio I/O, alignment, reconcile (numpy/soundfile);
+- :mod:`clear_record.providers` — per-vendor ASR backend adapters;
+- :mod:`clear_record.cli` — the ``clear-record`` command implementation.
+
+This module is deliberately light (a docstring only) so that importing
+``clear_record`` does not pull in the heavy CLI or audio stack. The console
+script targets :func:`clear_record.cli.main` directly.
+"""
+
+__all__: list[str] = []

clear_record-0.1.1/src/clear_record/cli/__init__.py

@@ -0,0 +1,7 @@
+"""clear_record.cli: the CLI implementation for the `clear-record` command."""
+
+from __future__ import annotations
+
+from clear_record.cli.cli import main
+
+__all__ = ["main"]

clear_record-0.1.1/src/clear_record/cli/__main__.py

@@ -0,0 +1,4 @@
+from clear_record.cli.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())