seraph-db 0.1.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 a built-in encoder. For higher encode throughput on NVIDIA GPUs, swap in a GPU or ONNX Runtime build from GitHub Releases — same API, faster ingest.

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

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