Metadata-Version: 2.4
Name: lattica-query-sunscreen
Version: 1.5.0
Summary: Client package for running inference queries on the LatticaAI platform (Sunscreen backend)
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.2
Requires-Dist: timeit-decorator>=2.0.8
Requires-Dist: sunscreen-fhe>=0.1.2
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)
