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 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.