Metadata-Version: 2.5
Name: holographic-sdk
Version: 0.1.2
Summary: HTTP client and agent-framework adapters for a Holographic Memory System service
Author-email: WritersLogic <david@writerslogic.com>
License: AGPL-3.0-or-later
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Provides-Extra: all
Requires-Dist: crewai>=0.28.0; extra == 'all'
Requires-Dist: dspy-ai>=2.4.0; extra == 'all'
Requires-Dist: embedchain>=0.1.114; extra == 'all'
Requires-Dist: haystack-ai>=2.0.0; extra == 'all'
Requires-Dist: langchain-core>=0.1.0; extra == 'all'
Requires-Dist: llama-index-core>=0.10.0; extra == 'all'
Requires-Dist: phidata>=2.4.0; extra == 'all'
Requires-Dist: pydantic-ai>=0.0.14; extra == 'all'
Requires-Dist: semantic-kernel>=1.0.0; extra == 'all'
Requires-Dist: smolagents>=1.0.0; extra == 'all'
Provides-Extra: crewai
Requires-Dist: crewai>=0.28.0; extra == 'crewai'
Provides-Extra: dspy
Requires-Dist: dspy-ai>=2.4.0; extra == 'dspy'
Provides-Extra: embedchain
Requires-Dist: embedchain>=0.1.114; extra == 'embedchain'
Provides-Extra: haystack
Requires-Dist: haystack-ai>=2.0.0; extra == 'haystack'
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.1.0; extra == 'langchain'
Provides-Extra: llamaindex
Requires-Dist: llama-index-core>=0.10.0; extra == 'llamaindex'
Provides-Extra: phidata
Requires-Dist: phidata>=2.4.0; extra == 'phidata'
Provides-Extra: pydantic-ai
Requires-Dist: pydantic-ai>=0.0.14; extra == 'pydantic-ai'
Provides-Extra: semantic-kernel
Requires-Dist: semantic-kernel>=1.0.0; extra == 'semantic-kernel'
Provides-Extra: smolagents
Requires-Dist: smolagents>=1.0.0; extra == 'smolagents'
Description-Content-Type: text/markdown

# Holographic SDK

HTTP client and agent-framework adapters for a Holographic Memory System service.

The client talks to a service exposing `POST /api/v1/documents/batch`, `POST /api/v1/documents`, `DELETE /api/v1/documents/{id}` and `POST /api/v1/query`. The `holographic-memory` repository does not ship that service; you must provide one.

## Vector masking

Passing `zero_trust_key` masks every embedding client-side with a keyed signed permutation (`VectorMask`, scrypt-derived). The server can still rank vectors because inner products and cosine similarity are preserved exactly. This is obfuscation, **not encryption**: the server learns all pairwise similarities, and known plain/masked pairs reveal the key for the coordinates they cover. Pass a per-collection `mask_salt` (at least 16 bytes) shared by all clients of that collection. Masks produced by 0.1.0/0.1.1 are not compatible and were not secure.

## Installation

Install the base SDK:
```bash
pip install holographic-sdk
```

Or install with specific framework integrations:
```bash
pip install "holographic-sdk[all]"
```

## Supported Integrations

```python
# LangChain
from holographic_sdk.langchain import HolographicVectorStore

# LlamaIndex
from holographic_sdk.llamaindex import HolographicVectorStore

# Haystack
from holographic_sdk.haystack import HolographicDocumentStore

# Microsoft Semantic Kernel
from holographic_sdk.semantic_kernel import HolographicMemoryStore

# DSPy
from holographic_sdk.dspy import HolographicRM

# CrewAI
from holographic_sdk.crewai import HolographicSearchTool

# Embedchain
from holographic_sdk.embedchain import HolographicDB

# Phidata
from holographic_sdk.phidata import HolographicVectorDb

# Pydantic AI
from holographic_sdk.pydantic_ai import get_holographic_tool

# SmolAgents
from holographic_sdk.smolagents import HolographicSearchTool
```
