Savant Engine SDK
Deterministic Geometric Governance for Embedding Pipelines
Savant Engine is a lightweight Geometry Control SDK designed to stabilize, audit, and govern vector embeddings produced by modern neural models.
It introduces deterministic geometric guarantees without modifying model weights or semantic content.
This SDK is model-agnostic and can wrap any embedding generator (Transformers, SentenceTransformers, local LLMs, or custom encoders).
Why Savant?
Modern embedding models can silently produce vectors with near-zero norms, leading to:
- NaN / Inf cosine similarities
- Reciprocal Rank Fusion (RRF) collapse
- Silent numerical corruption in production systems
Savant solves this by owning the geometry, not the model.
Core Principles
🔹 Geometry-Owned Architecture
The embedding manifold is governed by deterministic constraints, independent of the model’s internal distribution.
🔹 Silent Math
Under nominal conditions, Savant introduces zero distortion.
It only intervenes when geometric safety is violated.
🔹 Auditability
All stabilization events are logged, converting silent failures into traceable engineering signals.
Modules
savant_wrapper.py
Core stabilization wrapper that:
- Intercepts embedding vectors
- Enforces a minimum geometric norm (
r_min) - Logs stabilization events deterministically
geometry_audit.py
Lightweight audit utilities for:
- Recording stabilization events
- Inspecting geometric health
- Supporting safety-critical validation workflows
rrf_safe_similarity.py
Drop-in replacements for similarity operations:
- Safe cosine similarity
- RRF-compatible distance calculations
- Guaranteed finite outputs
Installation
pip install savant-engine
Or directly from Hugging Face:
pip install git+https://huggingface.co/antonypamo/savant-engine
Quick Start
from savant_wrapper import SavantWrapper
from sentence_transformers import SentenceTransformer
model = SentenceTransformer("all-MiniLM-L6-v2")
savant = SavantWrapper(
embedder=model,
r_min=1e-4
)
vec = savant.encode("Resonant Relational Framework")
print(vec.shape)
print(savant.audit_log)
Design Intent
Savant is not:
a model
a dataset
a fine-tuned checkpoint
Savant is:
an SDK
an infrastructure primitive
a deterministic safety layer for AI systems
Target Use Cases
Reciprocal Rank Fusion (RRF)
Vector databases
Safety-critical AI pipelines
Industrial / ISO-compliant ML systems
Research validation and benchmarking
License
MIT License
Author
Antony Padilla Morales
Costa Rica
“The model generates meaning.
Savant owns geometry.”