Privacy-First On-Device Numerology
The NUMINOS Deterministic Calculation Engine
Abstract. This whitepaper documents the architecture, cryptographic guarantees, and reproducibility properties of the NUMINOS calculation engine. Unlike SaaS numerology tools that transmit birth data and name inputs to server-side APIs, NUMINOS performs every one of its 200+ calculations entirely in the user's browser process. We describe the deterministic dispatch graph across 16 traditions, the zero-network-call numerology pipeline, the ephemeris fallback strategy, and the reproducibility harness that allows independent researchers to verify every computed value.
1. Introduction
Numerology tools have historically required users to submit their full legal name and date of birth to a remote server for calculation. This creates three categories of risk: unnecessary collection of personally identifying information (PII), inability to audit the calculation, and dependence on the operator's availability. NUMINOS resolves all three by running every numerological reduction, letter-value mapping, and cross-tradition synthesis in the browser's own JavaScript runtime.
2. Threat Model
We model four adversaries: (a) network observers who see traffic but not payloads; (b) network observers who see payloads; (c) the NUMINOS operator; (d) future operators after an acquisition or breach. Our design goal is that adversaries (b), (c), and (d) cannot learn the user's inputs or outputs by observing the normal flow of the application. Only the narrative interpretation layer — which is opt-in and routed through a model provider — touches the network with user-authored material.
3. Deterministic Dispatch Graph
The core engine is a pure-function DAG. Each node is a tradition-specific reducer: Pythagorean, Chaldean, Kabbalistic (six sub-methods), English Gematria, Greek Isopsephy, Abjad, Katapayadi, Agrippan, Zoroastrian, Chinese (Lo Shu), Tibetan Kalachakra (Parkha, Mewa, Luchak), Jain, Jyotisha (including Tamil En Jothidam), Mayan (Tzolkin + Haab), Norse Runic, and Vortex Mathematics. The DAG has no side effects, no network calls, and no non-determinism; given identical inputs it always produces identical outputs.
4. Master Number Preservation
Conventional numerology calculators reduce numbers naively, destroying master numbers 11, 22, 33, and 44. NUMINOS implements staged reduction: each date component is reduced independently before final aggregation, and master numbers are tagged and preserved in every position (Life Path, Destiny, Soul Urge, Personality, Birthday, Pinnacle, Challenge). We provide a formal proof that staged reduction is consistent with the classical Pythagorean literature and strictly dominates single-pass reduction for information preservation.
5. Ephemeris Strategy
Planetary positions for Vedic D1, Panchanga, Dasha, BaZi, and Returns require high-precision astronomical data. NUMINOS ships a compact ephemeris bundle (astronomy-engine) that runs fully client-side for the Sun, Moon, and five visible planets. For the outer planets we cache authoritative Swiss Ephemeris derived values in Supabase, fetched over HTTPS by day — still no input data leaves the device.
6. Reproducibility Harness
Every released version of the engine is pinned to an integrity hash. Researchers can clone the verification harness, feed it any birth data, and compare outputs against the published corpus. We publish a canonical test vector set of 1,024 birth charts spanning every master number position and every tradition output, with SHA-256 hashes of the expected outputs.
7. AI Interpretation Isolation
The optional narrative interpretation layer is strictly partitioned from the calculation engine. Interpretations receive only the computed outputs — never the raw name or full date. Users can disable the layer entirely and retain every calculation, chart, and timeline.
8. Limitations
Client-side computation is slower than server-side for very large batch runs. Our typical reading renders in 90–250 ms on mid-range mobile hardware, which we consider acceptable. We do not currently support offline ephemeris for outer-planet transits beyond 2040; users who require deeper future horizons can supply their own Swiss Ephemeris bundle.
9. Conclusion
Privacy-first numerology is not a marketing claim; it is an architectural property. The NUMINOS engine is the first full-stack, 16-tradition platform to achieve it while preserving academic reproducibility and cryptographic integrity. We invite researchers to audit the engine and verify the published corpus.