tidevec 0.1.0__py3-none-any.whl

tidevec-0.1.0.dist-info/METADATA

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: tidevec
+Version: 0.1.0
+Summary: Python SDK for TideVec — temporally-aware causal vector database
+Project-URL: Homepage, https://tidevec.io
+Project-URL: Repository, https://github.com/ashishodu2023/TideVec
+Project-URL: Documentation, https://tidevec.io/docs
+Project-URL: Bug Tracker, https://github.com/ashishodu2023/TideVec/issues
+Author-email: Ashish Verma <contact@getcortexops.com>
+License: Apache-2.0
+Keywords: ANN,RAG,agentic-AI,embeddings,vector-database
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Requires-Dist: grpcio-tools>=1.54.0
+Requires-Dist: grpcio>=1.54.0
+Requires-Dist: protobuf>=4.0.0
+Provides-Extra: dev
+Requires-Dist: black; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Provides-Extra: numpy
+Requires-Dist: numpy>=1.24; extra == 'numpy'
+Provides-Extra: pandas
+Requires-Dist: pandas>=2.0; extra == 'pandas'
+Description-Content-Type: text/markdown
+
+# tidevec-py
+
+Python SDK for [TideVec](https://github.com/ashishodu2023/TideVec) — the world's first temporally-aware, causally-indexed vector database.
+
+## Install
+
+```bash
+pip install tidevec-py
+```
+
+## Quick Start
+
+```python
+from tidevec import TideVec, HalfLife
+
+# Connect
+db = TideVec("localhost:6399")
+
+# Create a collection
+db.create_collection(
+    "docs",
+    dim=768,
+    half_life_ms=HalfLife.ONE_WEEK,   # fresh vectors rank higher
+    temporal_blend=0.3,               # 30% time, 70% semantic
+)
+
+# Upsert vectors
+db.upsert("docs", [
+    {
+        "id":        "doc_001",
+        "embedding": [0.1, 0.2, ...],  # 768-dim
+        "payload":   {"source": "confluence", "team": "platform"},
+        "ttl_seconds": 86400,          # expire in 24 hours
+    },
+    {
+        "id":        "doc_002",
+        "embedding": [0.3, 0.4, ...],
+        "payload":   {"source": "jira"},
+        "edges":     [{"target_id": "doc_001", "type": "UPDATES", "weight": 0.9}],
+    },
+])
+
+# Search with temporal scoring
+results = db.search(
+    "docs",
+    query_vector=[0.1, 0.2, ...],
+    top_k=10,
+    temporal_blend=0.3,
+    include_staleness_warnings=True,
+)
+
+for hit in results:
+    print(f"{hit.id}  score={hit.score:.4f}  temporal={hit.temporal_score:.3f}")
+    if hit.staleness_warning:
+        print(f"  ⚠️  {hit.staleness_reason}")
+
+# Causal expansion
+results = db.search(
+    "docs",
+    query_vector=[0.1, 0.2, ...],
+    mode="causal_expand",
+    causal_hops=2,
+)
+
+# Contradiction detection
+results = db.search(
+    "docs",
+    query_vector=[0.1, 0.2, ...],
+    mode="contradiction_check",
+)
+for hit in results:
+    if hit.contradicted_by:
+        print(f"{hit.id} is contradicted by {hit.contradicted_by}")
+
+# Batch search (GPU/TPU accelerated)
+responses = db.batch_search(
+    "docs",
+    query_vectors=[[0.1, ...], [0.5, ...], [0.9, ...]],
+    top_k=5,
+    device="gpu",   # "auto" | "gpu" | "tpu" | "cpu"
+)
+
+# With trace for observability (CortexOps integration)
+results = db.search("docs", query_vector=[...], include_trace=True)
+print(f"latency={results.latency_ms:.1f}ms  strategy={results.strategy}")
+```
+
+## Async
+
+```python
+import asyncio
+from tidevec import AsyncTideVec
+
+async def main():
+    async with AsyncTideVec("localhost:6399") as db:
+        await db.upsert("docs", [{"id": "v1", "embedding": [...]}])
+        results = await db.search("docs", query_vector=[...], top_k=5)
+        for hit in results:
+            print(hit.id, hit.score)
+
+asyncio.run(main())
+```
+
+## Context manager
+
+```python
+with TideVec("localhost:6399", api_key="mykey") as db:
+    db.create_collection("agents", dim=1536, half_life_ms=HalfLife.ONE_HOUR)
+    # ... operations
+# connection auto-closed
+```
+
+## HalfLife presets
+
+```python
+from tidevec import HalfLife
+
+HalfLife.AGENT_SESSION  # 1 hour   — per-session agent memory
+HalfLife.ONE_DAY        # 1 day    — news / feeds
+HalfLife.ONE_WEEK       # 7 days   — support tickets
+HalfLife.ONE_MONTH      # 30 days  — documents (default)
+HalfLife.ONE_YEAR       # 365 days — long-term knowledge base
+```

tidevec-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+tidevec/__init__.py,sha256=Cwg57L7eB-FVKWVh2zKuJ3HXP1ZhZsaryINdsWax60Y,344
+tidevec/client.py,sha256=zfxLodxFw_oSaJwA8wqWycSWf0vKaSxphjE1cD9db3g,20717
+tidevec/cortexdb_pb2.py,sha256=cSn5C8nFqoHoX_79yFulWGXhAN-4wyrk7U3dMshhMTk,14605
+tidevec/cortexdb_pb2_grpc.py,sha256=aJPHo3MMNE4fOEIIxGZ7jZJgVJWsnQFwhCK0PVHXZCA,24047
+tidevec/tidevec_pb2.py,sha256=EOZ9NlcIF4SIiGFjo5uQ75qbAKzY7NtgjT8sKaL61SI,14596
+tidevec/tidevec_pb2_grpc.py,sha256=aJPHo3MMNE4fOEIIxGZ7jZJgVJWsnQFwhCK0PVHXZCA,24047
+tidevec-0.1.0.dist-info/METADATA,sha256=4uI1iyzlIKfBiui_g2lJzVYGUkG90ahf6D9lUU_wueE,4536
+tidevec-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+tidevec-0.1.0.dist-info/RECORD,,

tidevec-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any