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 installs and runs everywhere, falling back to CPU when the GPU cannot be used — whether there is no NVIDIA card, no CUDA toolkit, or an unsupported driver. GPU acceleration additionally needs an NVIDIA GPU of compute capability 7.0 or newer plus the CUDA runtime libraries (cudart, cublas, curand); the driver alone is not sufficient. 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 you@company.com

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:

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

Variants

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.

See the License Agreement and Pricing Schedule 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.