seraph-db 0.2.1

SERAPH — deterministic semantic-geometry memory substrate (engine + licensing CLI)

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

pip install seraph-db

The wheel includes the full engine with GPU-accelerated encoding (candle + CUDA). It automatically falls back to CPU when no NVIDIA GPU is present — works everywhere, accelerates when it can. For maximum encoder throughput, see seraph-db-onnx.

Quick Start

1. Activate Your License

A license is required before the engine will accept operations:

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

# Headless (email verification with 6-digit code)
seraph license activate --email [e-mail]

2. Verify

seraph license status

3. Use

import seraph

cfg = seraph.StoreConfig(model_id="BAAI/bge-small-en-v1.5")
store = seraph.SeraphStore.create("my_store.sfg", cfg)

text = "The quick brown fox jumps over the lazy dog."
store.put(text.encode(), store.encode(text))    # content bytes + embedding

for hit in store.search_text("fast animal"):     # text query, encodes internally
    print(f"{hit.score:.3f}  {hit.snippet}")

store.close()

---

What's Included

The seraph-db wheel contains:

Component	Description
seraph Python module	Compiled Rust extension (PyO3) with GPU-accelerated encoder
seraph CLI	License management and store utilities

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

Variants

Package	Backend	Best for
seraph-db (this package)	candle + CUDA (CPU fallback)	Universal — GPU when available, CPU otherwise
seraph-db-onnx	ONNX Runtime CUDA EP	Maximum encoder throughput (~3x faster)

All variants expose the same API. Platform-specific archives with bundled runtimes are also available from GitHub Releases.

API Reference

Full API documentation:

• Python API Reference
• C FFI API Reference
• Product overview
• API Reference

---

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.

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	Per Order Form.

See the License Agreement and Pricing Schedule for full terms.

For licensing inquiries: [e-mail]

---

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.