Metadata-Version: 2.4
Name: seraph-db
Version: 0.1.1
Summary: SERAPH — deterministic semantic-geometry memory substrate (engine + licensing CLI)
Author-email: Tree D Interactive LLC <contact@tree-d-interactive.net>
License: LicenseRef-Proprietary
Project-URL: Homepage, https://www.seraph-db.com
Project-URL: Source, https://github.com/Tree-D-Interactive-LLC/seraph
Keywords: semantic-memory,agent-memory,provenance,vector-database,mcp
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Rust
Classifier: License :: Other/Proprietary License
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# SERAPH

**A geometric substrate for structured knowledge.**

SERAPH is a storage and retrieval engine that organizes content through emergent geometric structure rather than explicit schemas. It provides cryptographic provenance, semantic search, and chain-of-custody guarantees from genesis to tip.

---

## Install

```bash
pip install seraph-db
```

The wheel includes the full engine with a built-in encoder. For higher encode throughput on NVIDIA GPUs, swap in a GPU or ONNX Runtime build from [GitHub Releases](https://github.com/Tree-D-Interactive-LLC/seraph/releases) — same API, faster ingest.

## Quick Start

### 1. Activate Your License

A license is required before the engine will accept operations:

```bash
# Browser-based (opens your default browser)
seraph license activate

# Headless (email verification with 6-digit code)
seraph license activate --email you@company.com
```

### 2. Verify

```bash
seraph license status
```

### 3. Use

```python
import seraph

store = seraph.SeraphStore("my_store.sfg")
store.put("The quick brown fox jumps over the lazy dog.")
hits = store.search("fast animal", k=5)
for hit in hits:
    print(f"{hit.score:.3f}  {hit.text}")
store.close()
```

---

## What's Included

The `seraph-db` wheel contains:

| Component | Description |
|-----------|-------------|
| `seraph` Python module | Compiled Rust extension (PyO3) with built-in encoder |
| `seraph` CLI | License management and store utilities |

The CLI is installed as a console entry point — run `seraph --help` after install.

## Accelerated Builds

The pip wheel works out of the box. For production workloads with NVIDIA GPUs, drop-in replacements are available from [GitHub Releases](https://github.com/Tree-D-Interactive-LLC/seraph/releases) — same API, hardware-accelerated encoding:

| Variant | Backend | Best for |
|---------|---------|----------|
| **pip wheel** | candle (pure Rust) | Universal — works everywhere, no dependencies |
| **GPU** | candle + CUDA | GPU-accelerated encoding |
| **ONNX** | ONNX Runtime CUDA EP | Maximum encoder throughput (~3x faster than candle GPU) |

## API Reference

Full API documentation:

- [Python API Reference](https://github.com/Tree-D-Interactive-LLC/seraph/blob/main/PYTHON_API.md)
- [C FFI API Reference](https://github.com/Tree-D-Interactive-LLC/seraph/blob/main/FFI_API.md)
- [Product overview](https://seraph-db.com)
- [API Reference](https://seraph-db.com/docs)

---

## CLI Reference

```
seraph license activate              Activate a free license (opens browser)
seraph license activate --email E    Headless activation via email verification
seraph license install [path]        Install a license file
seraph license status                Show current license details
```

---

## Licensing

SERAPH is proprietary software licensed by [Tree D Interactive LLC](https://tree-d-interactive.net).

| Tier | Eligibility | Fee | Scope |
|------|------------|-----|-------|
| **Free** | Annual revenue under $500K | $0 | Development, evaluation, prototyping, non-commercial research. No production deployment. |
| **Commercial** | Annual revenue $500K+ | $10,000/year | Production deployment on your own infrastructure. No multi-tenant SaaS, white-label, or redistribution. |
| **Enterprise** | Multi-tenant SaaS, embedded redistribution, third-party deployment | [Contact us](mailto:licensing@tree-d-interactive.net) | Per Order Form. |

See the [License Agreement](https://www.seraph-db.com/license-agreement) and [Pricing Schedule](https://www.seraph-db.com/pricing) for full terms.

For licensing inquiries: **licensing@tree-d-interactive.net**

---

## Support

- **Free & Commercial:** GitHub Issues on this repository
- **Enterprise:** Direct support channel per agreement

---

Copyright (c) 2025-2026 Tree D Interactive LLC. All rights reserved.
