echo-vector 0.1.2__tar.gz → 1.0.4__tar.gz

echo_vector-1.0.4/.claude/commands/release.md

@@ -0,0 +1,15 @@
+Run the full release pipeline: lint, typecheck, test, commit, tag, and push to trigger CI/CD publish to PyPI.
+
+Usage: /release <version>   (e.g. /release v0.1.3)
+
+Steps:
+1. Verify a version argument was provided (format: vX.Y.Z)
+2. Run `uv run ruff format --check echovector/ tests/` and `uv run ruff check echovector/ tests/`
+3. Run `uv run mypy echovector/`
+4. Run `uv run pytest tests/ -m "not slow and not gpu" -q`
+5. If there are uncommitted changes, stage and commit them with message "release: $ARGUMENTS"
+6. Create git tag `$ARGUMENTS`
+7. Push the branch and the tag: `git push origin master` and `git push origin $ARGUMENTS`
+8. Report the tag that was pushed and remind the user to monitor CI at https://github.com/ahron-maslin/echo_vector/actions
+
+If any step fails, stop and report the failure before proceeding.

{echo_vector-0.1.2 → echo_vector-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: echo_vector
-Version: 0.1.2
+Version: 1.0.4
 Summary: Semantic text search over audio files without full transcription
 Project-URL: Homepage, https://github.com/ahron-maslin/echo_vector
 Project-URL: Documentation, https://github.com/ahron-maslin/echo_vector#readme

echo_vector-1.0.4/echovector/__init__.py

@@ -0,0 +1,18 @@
+"""EchoVector: Audio vector embedding and processing library."""
+
+import warnings
+
+from echovector.core import EchoVector
+
+# librosa falls back to its deprecated audioread loader for formats libsndfile
+# can't decode natively (e.g. m4a/aac), emitting a noisy FutureWarning we can't
+# act on from here.
+warnings.filterwarnings(
+    "ignore",
+    message="librosa.core.audio.__audioread_load",
+    category=FutureWarning,
+)
+
+__version__ = "0.1.0"
+
+__all__ = ["EchoVector"]

{echo_vector-0.1.2 → echo_vector-1.0.4}/echovector/cli/main.py

@@ -5,6 +5,7 @@ from typing import Annotated
 
 import typer
 from rich.console import Console
+from rich.progress import Progress
 from rich.table import Table
 
 from echovector import EchoVector
@@ -74,7 +75,16 @@ def index(
             )
         if reset:
             engine.reset()
-        count = engine.index(files, recursive=recursive)
+
+        with Progress(console=console) as progress:
+            task = progress.add_task("Indexing files...", total=None)
+
+            def _on_file_indexed(done: int, total: int, file_path: Path) -> None:
+                progress.update(
+                    task, total=total, completed=done, description=f"Indexed {file_path.name}"
+                )
+
+            count = engine.index(files, recursive=recursive, on_file_indexed=_on_file_indexed)
     except Exception as exc:
         console.print(f"[bold red]Indexing failed:[/bold red] {exc}")
         raise typer.Exit(code=1) from exc

{echo_vector-0.1.2 → echo_vector-1.0.4}/echovector/core.py

@@ -1,6 +1,6 @@
 """Core public API for EchoVector."""
 
-from collections.abc import Sequence
+from collections.abc import Callable, Sequence
 from pathlib import Path
 from tempfile import TemporaryDirectory
 from typing import Any, cast
@@ -67,6 +67,7 @@ class EchoVector:
         recursive: bool | None = None,
         batch_size: int = 16,
         force: bool = False,
+        on_file_indexed: Callable[[int, int, Path], None] | None = None,
     ) -> int:
         """Index audio chunks from paths or directories.
 
@@ -76,6 +77,9 @@ class EchoVector:
             batch_size: Number of chunks to embed per batch.
             force: If True, remove and re-index files that are already stored.
                    If False (default), already-indexed files are skipped.
+            on_file_indexed: Optional callback invoked after each file is
+                processed, with (files_done, total_files, file_path). Useful
+                for reporting progress.
 
         Returns:
             Number of new chunks added to the index.
@@ -103,7 +107,7 @@ class EchoVector:
             chunk_ids: list[str] = []
             chunk_metadata: list[dict[str, Any]] = []
 
-            for file_path in files:
+            for file_number, file_path in enumerate(files, start=1):
                 audio = self.audio_processor.load_audio(str(file_path))
                 for (
                     chunk_number,
@@ -131,6 +135,9 @@ class EchoVector:
                         chunk_ids = []
                         chunk_metadata = []
 
+                if on_file_indexed is not None:
+                    on_file_indexed(file_number, len(files), file_path)
+
             if chunk_paths:
                 self._add_chunk_batch(chunk_paths, chunk_ids, chunk_metadata)
 

{echo_vector-0.1.2 → echo_vector-1.0.4}/echovector/embeddings/clap.py

@@ -1,20 +1,16 @@
 """CLAP (Contrastive Language-Audio Pretraining) embedding backend."""
 
-from typing import cast
+from typing import Any, cast
 
 import librosa
 import numpy as np
 import numpy.typing as npt
+import torch
+from transformers import ClapModel, ClapProcessor
 
 from echovector.embeddings.base import EmbeddingBackend
 
-try:
-    import torch
-    from transformers import ClapModel, ClapProcessor
-
-    _CLAP_AVAILABLE = True
-except ImportError:  # pragma: no cover
-    _CLAP_AVAILABLE = False
+_CLAP_AVAILABLE = True
 
 
 class ClapBackend(EmbeddingBackend):
@@ -33,22 +29,14 @@ class ClapBackend(EmbeddingBackend):
         Args:
             model_name: The Hugging Face model identifier.
             device: Device to run the model on (e.g., 'cpu', 'cuda').
-
-        Raises:
-            ImportError: If torch or transformers are not installed.
         """
-        if not _CLAP_AVAILABLE:
-            raise ImportError(
-                "CLAP backend requires torch and transformers. "
-                "Install them with: pip install echo_vector"
-            )
         if device is None:
             self.device = "cuda" if torch.cuda.is_available() else "cpu"
         else:
             self.device = device
 
-        self.processor = ClapProcessor.from_pretrained(model_name)
-        self.model = ClapModel.from_pretrained(model_name)
+        self.processor: Any = ClapProcessor.from_pretrained(model_name)  # pyright: ignore[reportArgumentType]
+        self.model: Any = ClapModel.from_pretrained(model_name)  # pyright: ignore[reportArgumentType]
         self.model.to(self.device)
         self.model.eval()
 
@@ -81,7 +69,7 @@ class ClapBackend(EmbeddingBackend):
 
         audios = [self._load_and_resample(path, target_sr) for path in audio_paths]
 
-        inputs = self.processor(
+        inputs = cast("Any", self.processor)(
             audios=audios,
             return_tensors="pt",
             sampling_rate=target_sr,
@@ -107,7 +95,7 @@ class ClapBackend(EmbeddingBackend):
         Returns:
             A numpy array of shape (batch_size, embedding_dim).
         """
-        inputs = self.processor(
+        inputs = cast("Any", self.processor)(
             text=texts,
             return_tensors="pt",
             padding=True,

{echo_vector-0.1.2 → echo_vector-1.0.4}/uv.lock

@@ -477,14 +477,16 @@ dependencies = [
     { name = "pydub" },
     { name = "rich" },
     { name = "soundfile" },
+    { name = "torch" },
     { name = "tqdm" },
+    { name = "transformers" },
     { name = "typer" },
 ]
 
 [package.optional-dependencies]
 all = [
     { name = "fastapi" },
-    { name = "httpx" },
+    { name = "httpx2" },
     { name = "hypothesis" },
     { name = "mkdocs-gen-files" },
     { name = "mkdocs-literate-nav" },
@@ -498,20 +500,14 @@ all = [
     { name = "pytest-cov" },
     { name = "pytest-xdist" },
     { name = "ruff" },
-    { name = "torch" },
-    { name = "transformers" },
     { name = "uvicorn", extra = ["standard"] },
 ]
 api = [
     { name = "fastapi" },
     { name = "uvicorn", extra = ["standard"] },
 ]
-clap = [
-    { name = "torch" },
-    { name = "transformers" },
-]
 dev = [
-    { name = "httpx" },
+    { name = "httpx2" },
     { name = "hypothesis" },
     { name = "mutmut" },
     { name = "mypy" },
@@ -529,18 +525,13 @@ docs = [
     { name = "mkdocstrings", extra = ["python"] },
 ]
 
-[package.dev-dependencies]
-dev = [
-    { name = "httpx" },
-]
-
 [package.metadata]
 requires-dist = [
     { name = "faiss-cpu", specifier = ">=1.7,<2" },
     { name = "fastapi", marker = "extra == 'all'", specifier = ">=0.109,<1" },
     { name = "fastapi", marker = "extra == 'api'", specifier = ">=0.109,<1" },
-    { name = "httpx", marker = "extra == 'all'", specifier = ">=0.27,<1" },
-    { name = "httpx", marker = "extra == 'dev'", specifier = ">=0.27,<1" },
+    { name = "httpx2", marker = "extra == 'all'", specifier = ">=2.0,<3" },
+    { name = "httpx2", marker = "extra == 'dev'", specifier = ">=2.0,<3" },
     { name = "hypothesis", marker = "extra == 'all'", specifier = ">=6.92,<7" },
     { name = "hypothesis", marker = "extra == 'dev'", specifier = ">=6.92,<7" },
     { name = "librosa", specifier = ">=0.10,<1" },
@@ -570,22 +561,17 @@ requires-dist = [
     { name = "pytest-xdist", marker = "extra == 'all'", specifier = ">=3.5,<4" },
     { name = "pytest-xdist", marker = "extra == 'dev'", specifier = ">=3.5,<4" },
     { name = "rich", specifier = ">=13.7,<14" },
-    { name = "ruff", marker = "extra == 'all'", specifier = ">=0.3,<1" },
-    { name = "ruff", marker = "extra == 'dev'", specifier = ">=0.3,<1" },
+    { name = "ruff", marker = "extra == 'all'", specifier = ">=0.15,<1" },
+    { name = "ruff", marker = "extra == 'dev'", specifier = ">=0.15,<1" },
     { name = "soundfile", specifier = ">=0.12,<1" },
-    { name = "torch", marker = "extra == 'all'", specifier = ">=2.1,<3" },
-    { name = "torch", marker = "extra == 'clap'", specifier = ">=2.1,<3" },
+    { name = "torch", specifier = ">=2.1,<3" },
     { name = "tqdm", specifier = ">=4.66,<5" },
-    { name = "transformers", marker = "extra == 'all'", specifier = ">=4.36,<5" },
-    { name = "transformers", marker = "extra == 'clap'", specifier = ">=4.36,<5" },
+    { name = "transformers", specifier = ">=4.36,<5" },
     { name = "typer", extras = ["all"], specifier = ">=0.12,<1" },
     { name = "uvicorn", extras = ["standard"], marker = "extra == 'all'", specifier = ">=0.27,<1" },
     { name = "uvicorn", extras = ["standard"], marker = "extra == 'api'", specifier = ">=0.27,<1" },
 ]
-provides-extras = ["all", "api", "clap", "dev", "docs"]
-
-[package.metadata.requires-dev]
-dev = [{ name = "httpx", specifier = ">=0.28.1" }]
+provides-extras = ["all", "api", "dev", "docs"]
 
 [[package]]
 name = "execnet"
@@ -717,16 +703,16 @@ wheels = [
 ]
 
 [[package]]
-name = "httpcore"
-version = "1.0.9"
+name = "httpcore2"
+version = "2.3.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "certifi" },
     { name = "h11" },
+    { name = "truststore" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/e6/34/18f1c596e677962f040284246f393b10a1f8ce440b3a7e69c637d0f1c7ad/httpcore2-2.3.0.tar.gz", hash = "sha256:07327e251560960eea8e969d92d4c6a325feb13cca39e25340731336c3baf924", size = 64300, upload-time = "2026-06-01T13:15:02.998Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/dd/3357218c69360d1cecc196c230c9a1d5c9afd5dba362056e23e60a5e64e5/httpcore2-2.3.0-py3-none-any.whl", hash = "sha256:477e9e334f74e5240dcac002e890580f36a57d40ff0fb14cc9655731d23b8415", size = 80024, upload-time = "2026-06-01T13:15:00.001Z" },
 ]
 
 [[package]]
@@ -759,18 +745,18 @@ wheels = [
 ]
 
 [[package]]
-name = "httpx"
-version = "0.28.1"
+name = "httpx2"
+version = "2.3.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "anyio" },
-    { name = "certifi" },
-    { name = "httpcore" },
+    { name = "httpcore2" },
     { name = "idna" },
+    { name = "truststore" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/9f/9a/cca0b9145f13d8ae34b885ae28d403a1469a433abc78e0f94f4ce94e650b/httpx2-2.3.0.tar.gz", hash = "sha256:227e7c41d95a76d4077a52640564132777215fc3394e07b66a3116c33d668fa9", size = 81115, upload-time = "2026-06-01T13:15:04.324Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+    { url = "https://files.pythonhosted.org/packages/87/ce/ae2911859847f9ba1d6b23027e53481cbeb50b93234f355a968d300ca2cb/httpx2-2.3.0-py3-none-any.whl", hash = "sha256:6f393663bdf6dbe7fe90118e3eb5b2bd024a675cae0390ac08cec9198812d8b7", size = 74538, upload-time = "2026-06-01T13:15:01.566Z" },
 ]
 
 [[package]]
@@ -2544,6 +2530,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/c1/68/fa86e5a39608000f645535b2c124920126327ab731f8c4fafd5b07ff8d4b/triton-3.7.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ce061073102714b725f3660ec6939d94a1da7984b3aa99c921417cae273672f5", size = 201546766, upload-time = "2026-05-07T18:46:42.088Z" },
 ]
 
+[[package]]
+name = "truststore"
+version = "0.10.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/53/a3/1585216310e344e8102c22482f6060c7a6ea0322b63e026372e6dcefcfd6/truststore-0.10.4.tar.gz", hash = "sha256:9d91bd436463ad5e4ee4aba766628dd6cd7010cf3e2461756b3303710eebc301", size = 26169, upload-time = "2025-08-12T18:49:02.73Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/19/97/56608b2249fe206a67cd573bc93cd9896e1efb9e98bce9c163bcdc704b88/truststore-0.10.4-py3-none-any.whl", hash = "sha256:adaeaecf1cbb5f4de3b1959b42d41f6fab57b2b1666adb59e89cb0b53361d981", size = 18660, upload-time = "2025-08-12T18:49:01.46Z" },
+]
+
 [[package]]
 name = "typer"
 version = "0.25.1"

echo_vector-0.1.2/echovector/__init__.py

@@ -1,7 +0,0 @@
-"""EchoVector: Audio vector embedding and processing library."""
-
-from echovector.core import EchoVector
-
-__version__ = "0.1.0"
-
-__all__ = ["EchoVector"]