tidevec 0.1.0__tar.gz

tidevec-0.1.0/.gitignore

@@ -0,0 +1,60 @@
+cd ~/tidevec
+
+cat > .gitignore << 'EOF'
+# Build artifacts
+build/
+build_check/
+cmake-build-*/
+*.o
+*.obj
+*.so
+*.dylib
+*.dll
+*.a
+*.exe
+
+# CMake
+CMakeCache.txt
+CMakeFiles/
+cmake_install.cmake
+CTestTestfile.cmake
+Makefile
+*.cmake
+!cmake/*.cmake
+!sdk/cpp/cmake/*.cmake.in
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+.eggs/
+*.whl
+
+# Go
+sdk/go/vendor/
+
+# Java
+sdk/java/target/
+*.class
+*.jar
+
+# Node / website
+node_modules/
+website/dist/
+*.log
+
+# IDE
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+EOF
+
+# Verify it landed correctly
+cat .gitignore
+wc -l .gitignore

tidevec-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,123 @@
+# 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/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name            = "tidevec"
+version         = "0.1.0"
+description     = "Python SDK for TideVec — temporally-aware causal vector database"
+readme          = "README.md"
+license         = { text = "Apache-2.0" }
+authors         = [{ name = "Ashish Verma", email = "contact@getcortexops.com" }]
+requires-python = ">=3.9"
+keywords        = ["vector-database", "embeddings", "ANN", "RAG", "agentic-AI"]
+classifiers     = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Database",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "grpcio>=1.54.0",
+    "grpcio-tools>=1.54.0",
+    "protobuf>=4.0.0",
+]
+
+[project.optional-dependencies]
+numpy  = ["numpy>=1.24"]
+pandas = ["pandas>=2.0"]
+dev    = ["pytest>=7", "pytest-asyncio", "black", "mypy"]
+
+[project.urls]
+Homepage      = "https://tidevec.io"
+Repository    = "https://github.com/ashishodu2023/TideVec"
+Documentation = "https://tidevec.io/docs"
+"Bug Tracker" = "https://github.com/ashishodu2023/TideVec/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["tidevec"]

tidevec-0.1.0/tidevec/__init__.py

@@ -0,0 +1,20 @@
+"""TideVec Python SDK — Temporally-aware causal vector database."""
+
+from .client import (
+    TideVec,
+    AsyncTideVec,
+    SearchHit,
+    SearchResponse,
+    CollectionInfo,
+    HalfLife,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    "TideVec",
+    "AsyncTideVec",
+    "SearchHit",
+    "SearchResponse",
+    "CollectionInfo",
+    "HalfLife",
+]