mirror of
https://github.com/MrSleeps/jellyfin-scene-search.git
synced 2026-11-17 23:41:28 +00:00
74 lines
2.5 KiB
Python
74 lines
2.5 KiB
Python
from __future__ import annotations
|
|
|
|
from collections.abc import Iterable
|
|
|
|
import requests
|
|
|
|
|
|
class Meili:
|
|
def __init__(self, url: str, master_key: str, index: str) -> None:
|
|
self.url = url.rstrip("/")
|
|
self.index = index
|
|
self.session = requests.Session()
|
|
if master_key:
|
|
self.session.headers.update({"Authorization": f"Bearer {master_key}"})
|
|
self.session.headers.update({"Content-Type": "application/json"})
|
|
|
|
def _check(self, response: requests.Response) -> requests.Response:
|
|
if not response.ok:
|
|
raise RuntimeError(f"Meilisearch {response.status_code}: {response.text}")
|
|
return response
|
|
|
|
@staticmethod
|
|
def _json_vector(vector: Iterable[float]) -> list[float]:
|
|
"""Convert NumPy/PyTorch scalar values into JSON-native floats."""
|
|
return [float(value) for value in vector]
|
|
|
|
def ensure_index(self) -> None:
|
|
r = self.session.get(f"{self.url}/indexes/{self.index}")
|
|
if r.status_code == 404:
|
|
self._check(self.session.post(
|
|
f"{self.url}/indexes",
|
|
json={"uid": self.index, "primaryKey": "id"},
|
|
))
|
|
else:
|
|
self._check(r)
|
|
|
|
def configure_user_vectors(self, dimensions: int) -> None:
|
|
self.ensure_index()
|
|
self._check(self.session.patch(
|
|
f"{self.url}/indexes/{self.index}/settings/embedders",
|
|
json={"siglip2": {"source": "userProvided", "dimensions": dimensions}},
|
|
))
|
|
self._check(self.session.put(
|
|
f"{self.url}/indexes/{self.index}/settings/filterable-attributes",
|
|
json=["media_id", "title"],
|
|
))
|
|
|
|
def add_documents(self, documents: list[dict]) -> None:
|
|
if not documents:
|
|
return
|
|
self._check(self.session.post(
|
|
f"{self.url}/indexes/{self.index}/documents",
|
|
params={"primaryKey": "id"},
|
|
json=documents,
|
|
))
|
|
|
|
def stats(self) -> dict:
|
|
self.ensure_index()
|
|
return self._check(
|
|
self.session.get(f"{self.url}/indexes/{self.index}/stats")
|
|
).json()
|
|
|
|
def search_vector(self, vector: Iterable[float], limit: int = 10) -> dict:
|
|
payload = {
|
|
"vector": self._json_vector(vector),
|
|
"hybrid": {"embedder": "siglip2", "semanticRatio": 1.0},
|
|
"limit": limit,
|
|
"showRankingScore": True,
|
|
}
|
|
return self._check(self.session.post(
|
|
f"{self.url}/indexes/{self.index}/search",
|
|
json=payload,
|
|
)).json()
|