echo-vector 0.1.1__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.1 → echo_vector-1.0.3}/.gitignore

@@ -65,3 +65,12 @@ Thumbs.db
 
 # Benchmark outputs
 benchmark_results/
+
+# Demo artifacts
+demo_audio/
+demo_index/
+demo.py
+
+# EchoVector index stores
+ev-index/
+*-index/

{echo_vector-0.1.1 → echo_vector-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: echo_vector
-Version: 0.1.1
+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
@@ -30,7 +30,9 @@ Requires-Dist: pydantic<3,>=2.5
 Requires-Dist: pydub<1,>=0.25
 Requires-Dist: rich<14,>=13.7
 Requires-Dist: soundfile<1,>=0.12
+Requires-Dist: torch<3,>=2.1
 Requires-Dist: tqdm<5,>=4.66
+Requires-Dist: transformers<5,>=4.36
 Requires-Dist: typer[all]<1,>=0.12
 Provides-Extra: all
 Requires-Dist: fastapi<1,>=0.109; extra == 'all'
@@ -48,15 +50,10 @@ Requires-Dist: pytest-cov<6,>=5.0; extra == 'all'
 Requires-Dist: pytest-xdist<4,>=3.5; extra == 'all'
 Requires-Dist: pytest<9,>=8.0; extra == 'all'
 Requires-Dist: ruff<1,>=0.15; extra == 'all'
-Requires-Dist: torch<3,>=2.1; extra == 'all'
-Requires-Dist: transformers<5,>=4.36; extra == 'all'
 Requires-Dist: uvicorn[standard]<1,>=0.27; extra == 'all'
 Provides-Extra: api
 Requires-Dist: fastapi<1,>=0.109; extra == 'api'
 Requires-Dist: uvicorn[standard]<1,>=0.27; extra == 'api'
-Provides-Extra: clap
-Requires-Dist: torch<3,>=2.1; extra == 'clap'
-Requires-Dist: transformers<5,>=4.36; extra == 'clap'
 Provides-Extra: dev
 Requires-Dist: httpx2<3,>=2.0; extra == 'dev'
 Requires-Dist: hypothesis<7,>=6.92; extra == 'dev'
@@ -121,13 +118,13 @@ Text Query → Text Embedding ──────────────┘
 ### Installation
 
 ```bash
-pip install echovector
+pip install echo_vector
 ```
 
 Or with uv:
 
 ```bash
-uv add echovector
+uv add echo_vector
 ```
 
 ### CLI Usage

{echo_vector-0.1.1 → echo_vector-1.0.3}/README.md

@@ -44,13 +44,13 @@ Text Query → Text Embedding ──────────────┘
 ### Installation
 
 ```bash
-pip install echovector
+pip install echo_vector
 ```
 
 Or with uv:
 
 ```bash
-uv add echovector
+uv add echo_vector
 ```
 
 ### CLI Usage

{echo_vector-0.1.1 → 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[clap]'"
-            )
         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.1 → echo_vector-1.0.3}/pyproject.toml

@@ -37,13 +37,11 @@ dependencies = [
     "rich>=13.7,<14",
     "pydub>=0.25,<1",
     "tqdm>=4.66,<5",
-]
-
-[project.optional-dependencies]
-clap = [
     "torch>=2.1,<3",
     "transformers>=4.36,<5",
 ]
+
+[project.optional-dependencies]
 api = [
     "fastapi>=0.109,<1",
     "uvicorn[standard]>=0.27,<1",
@@ -66,7 +64,7 @@ docs = [
     "mkdocs-gen-files>=0.5,<1",
     "mkdocs-literate-nav>=0.6,<1",
 ]
-all = ["echo_vector[clap,api,dev,docs]"]
+all = ["echo_vector[api,dev,docs]"]
 
 [project.scripts]
 echovector = "echovector.cli.main:app"

{echo_vector-0.1.1 → 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"

echo_vector-0.1.1/.claude/settings.json

@@ -1,16 +0,0 @@
-{
-  "hooks": {
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "git add -A && git diff --cached --quiet || (COUNT=$(git diff --cached --name-only | wc -l | tr -d ' '); FILES=$(git diff --cached --name-only | head -3 | tr '\n' ' ' | sed 's/ $//'); if [ \"$COUNT\" -le 3 ]; then MSG=\"auto: edit $FILES\"; else FIRST=$(git diff --cached --name-only | head -2 | paste -sd ', '); MSG=\"auto: edit $COUNT files ($FIRST, ...)\"; fi; git commit -m \"$MSG\" 2>/dev/null || true)",
-            "statusMessage": "Committing changes..."
-          }
-        ]
-      }
-    ]
-  }
-}

echo_vector-0.1.1/demo.py

@@ -1,76 +0,0 @@
-import os
-
-import numpy as np
-import soundfile as sf
-
-from echovector import EchoVector
-from echovector.utils.logging import setup_logger
-
-logger = setup_logger("demo")
-
-def generate_synthetic_wav(
-    filepath: str,
-    duration: float,
-    sr: int = 16000,
-    freq: float = 440.0,
-) -> None:
-    """Generates a synthetic sine wave and saves it to a wav file."""
-    t = np.linspace(0, duration, int(sr * duration), endpoint=False)
-    # Simple tone
-    data = 0.5 * np.sin(2 * np.pi * freq * t)
-    os.makedirs(os.path.dirname(filepath), exist_ok=True)
-    sf.write(filepath, data, sr)
-    logger.info(f"Generated synthetic audio at {filepath}")
-
-def main() -> None:
-    """Run an end-to-end local EchoVector demo."""
-    print("=== EchoVector End-to-End Demo ===")
-
-    # 1. Setup temporary audio directory and build index
-    audio_dir = "./demo_audio"
-    index_dir = "./demo_index"
-
-    os.makedirs(audio_dir, exist_ok=True)
-    os.makedirs(index_dir, exist_ok=True)
-
-    # Generate a few synthetic audio clips
-    # Clip 1: A short alert/sound (high frequency)
-    generate_synthetic_wav(f"{audio_dir}/alert.wav", duration=5.0, freq=880.0)
-    # Clip 2: A low tone (bass discussion)
-    generate_synthetic_wav(f"{audio_dir}/bass_talk.wav", duration=10.0, freq=110.0)
-
-    # 2. Instantiate EchoVector
-    print("\n--- Initializing EchoVector ---")
-    # Use the local backend so the demo runs without GPU access or model downloads.
-    ev = EchoVector(store_dir=index_dir, backend="local")
-
-    # 3. Index the synthetic audio directory
-    print("\n--- Indexing Audio ---")
-    ev.index(audio_dir)
-
-    # 4. Search across indexed audio
-    print("\n--- Searching the Index ---")
-    # Since CLAP maps descriptive text queries to audio features, we query semantically
-    query = "high frequency alarm tone"
-    print(f"Searching for: '{query}'")
-    results = ev.search(query, top_k=2)
-
-    print("\nSearch Results:")
-    for i, r in enumerate(results, 1):
-        print(
-            f"{i}. File: {r.filepath} | "
-            f"Start: {r.timestamp_range.start:.2f}s | "
-            f"End: {r.timestamp_range.end:.2f}s | "
-            f"Score: {r.score:.4f}"
-        )
-
-    # 5. Index statistics
-    print("\n--- Index Statistics ---")
-    stats = ev.stats()
-    for k, v in stats.items():
-        print(f"{k}: {v}")
-
-    print("\nDemo completed successfully!")
-
-if __name__ == "__main__":
-    main()