Metadata-Version: 2.4
Name: lattica-query
Version: 1.4.4
Summary: Client package for running inference queries on the LatticaAI platform
Author-email: "LatticaAI Inc." <support@lattica.ai>
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: lattica-common>=0.8.1
Requires-Dist: timeit-decorator>=2.0.8
Requires-Dist: python-dotenv==1.0.1
Requires-Dist: lattica-fhe-core>=0.11.0
Requires-Dist: torch==2.9.1
Requires-Dist: pybind11>=2.13.6
Requires-Dist: numpy>=2.0.0
Requires-Dist: protobuf==5.27.1
Dynamic: license-file

# Lattica Query Client

A Python client library for securely executing AI inference with homomorphic encryption (HE) on Lattica's cloud platform.

## Installation

The package is split into two separate PyPI packages based on the FHE backend. Install only the one you need:

```bash
# For LATTICA (GPU-based FHE) - includes lattica-fhe-core, torch, numpy, protobuf
pip install lattica-query

# For SUNSCREEN (CPU-based TFHE) - includes sunscreen-fhe
pip install lattica-query-sunscreen
```

> **Note:** Only install one package at a time. Both provide the `lattica_query` module; installing both will cause conflicts.

## Usage

### Factory Pattern (recommended)

```python
from lattica_query import create_query_client

# Auto-detects scheme based on installed backend (lattica-fhe-core vs sunscreen-fhe)
client = create_query_client(query_token="<your-query-token>")
```

### Direct Import

```python
# LATTICA scheme
from lattica_query import QueryClient
client = QueryClient(query_token="<your-query-token>")

# SUNSCREEN scheme
from lattica_query import QueryClientSunscreen
client = QueryClientSunscreen(query_token="<your-query-token>")
```

## Documentation

See documentation at: https://platformdocs.lattica.ai/

## License

Proprietary - (c) Lattica AI
See license details in the `LICENSE.md` file.

---

For more information, visit [https://www.lattica.ai](https://www.lattica.ai)
