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

echo_vector-1.0.3/.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.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: echo_vector
-Version: 0.1.2
+Version: 1.0.3
 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-0.1.2 → echo_vector-1.0.3}/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.3}/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"