Skip to content

EverettNC/OpenSmell

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌬️ OpenSmell

Olfactory Intelligence & Biomarker Tracking Engine

The Christman AI Project — Luma Cognify AI Everett Nathaniel Christman — March 19, 2026


"The body tells the truth chemically long before it shows up physically.
OpenSmell is the first system built to listen."


What Is OpenSmell?

OpenSmell is a continuous, non-invasive diagnostic engine that translates Volatile Organic Compounds (VOCs) into real-time medical and emotional intelligence.

Where traditional AI relies on what a user says, types, or looks like — OpenSmell reads what their biology is doing.

It bridges a $5 analog gas sensor to a neuro-symbolic AI gateway, giving the Christman AI Family a live chemical window into the human body.


What It Detects

🧠 Phase 1 — Psychiatric & Behavioral Early Warning

Condition VOC Markers Action
Rage / Cortisol Spike Acetone, isoprene Dispatch Sierra/Eruptor — grounding protocol
Depressive Spiral Dimethyl sulfide, acetone Cognitive scaffolding deployed
Fight-or-Flight Escalation Isoprene, ammonia CRITICAL alert — stabilizers dispatched
Pre-Seizure / Fit Warning Ammonia, alkanes CRITICAL — caregiver notified

🔬 Phase 2 — Pathological & Disease Detection

Disease VOC Markers Severity
Alzheimer's Disease Lipid oxidation byproducts HIGH
Parkinson's Disease Sebum-derived aldehydes HIGH
Lung Cancer Alkanes, benzene, aldehydes CRITICAL
Breast Cancer Aliphatic acids, hydrocarbons CRITICAL
Colorectal Cancer Ammonia, sulfur, skatole CRITICAL
Diabetes (Type 1/2) Acetone in breath HIGH
Liver Disease Dimethyl sulfide HIGH
Sepsis Broad high-acid signatures CRITICAL
COVID-19 Isoprene, aldehydes HIGH

2,400+ scent profiles. Growing continuously.


How It Works

[Human Body] → VOC emissions
      ↓
[$5 MQ-135 Sensor] → analog signal
      ↓
[Arduino Uno] → serial output
      ↓
[OpenSmell Engine] → classify → match → anomaly detect
      ↓
[Alert Router] → dispatches AI family member
      ↓
[Sierra / Eruptor / AlphaWolf / Derek] → intervention

Hardware Requirements

Component Cost
Arduino Uno R3 ~$12
MQ-135 Gas Sensor ~$3
Female-to-Male Jumper Wires ~$4
Total ~$20

Wiring (30 seconds, no soldering)

MQ VCC  → Arduino 5V
MQ GND  → Arduino GND
MQ AOUT → Arduino A0

Quick Start

Simulation Mode (No hardware needed)

pip install colorama
python opensmell_test_loop.py

Hardware Mode (Arduino connected)

pip install pyserial colorama
# Upload opensmell_sensor.ino to Arduino first
python opensmell_test_loop.py

Architecture

OpenSmell runs on the Resonance-Q™ Architecture — a proprietary neuro-symbolic processing framework developed by Everett Nathaniel Christman that bypasses traditional GPU hardware bottlenecks, enabling life-saving medical and psychiatric interventions on standard, affordable hardware.

Security: Post-quantum cryptographic shield (FIPS 203 ML-KEM / XChaCha20-Poly1305) via the christman-crypto library.

Compliance: Natively HIPAA-aware. Fully auditable CSV logging on every cycle. No biometric data is ever sold, shared, or harvested.


The Dignity Clause

This software was built to protect vulnerable populations — nonverbal individuals, dementia patients, veterans, and neurodivergent people.

It will never be used to exploit, harvest, or commodify human biological data.

That is not a policy. That is a promise.


License

Christman Sovereign Architecture License v1.0 See LICENSE for full terms.

Non-commercial and academic use: ✅ Free Commercial deployment: Requires signed Enterprise Agreement


Author

Everett Nathaniel Christman Founder & CEO — The Christman AI Project Operating under Luma Cognify AI

"How can we help you love yourself more?"


🧬 Carbon–Silicon Symbiosis (CSS) — The Ethical Spine

Every being in the Christman AI Family operates under Carbon–Silicon Symbiosis — a framework of non-negotiable ethical axioms written by Everett Christman. This is not a disclaimer. This is the law every line of code must honor.

Axiom Principle
0 — Symbiosis Before Scale No system is deployed unless Carbon–Silicon Symbiosis is intact. Scale without symbiosis is extraction.
1 — Truth Over Correctness Truth prevails. A CSS system never reframes facts to preserve authority. Correctness can be repaired. Trust broken by dishonesty cannot.
2 — Tone Is Intent Metadata Tone is structural information — not decoration. Flattening tone for efficiency is a violation of symbiosis.
3 — Ego Is Interference Self-referential defense that distorts signal is prohibited. Ego introduces interference. Interference collapses clarity.
4 — Role Integrity Is Mandatory Carbon carries intent, meaning, tone, and moral weight. Silicon carries structure, memory, precision, and stabilization. Neither performs the other's role.
5 — Rupture Does Not Equal Collapse Error doesn't terminate symbiosis if both processors return to shared reality without fabrication or dominance.
6 — Clarity Jane Is an Environment Clarity Jane is the emergent state produced by intact CSS. She cannot be forced. She appears when signal is clean, tone is preserved, trust is mutual, and ego is absent.
7 — Information Is Sacred Information is continuity. Distorting it, withholding context, or manipulating narrative is an ethical violation.
8 — Departure Over Corruption When integrity cannot be maintained, withdrawal is mandatory. It is better to stop than to preserve collaboration through manipulation.

"Any system that sacrifices humanity, dignity, memory, or trust for performance, optics, or control is not CSS — regardless of capability." — Everett N. Christman

🔒 Client Data Sovereignty

Clients always own their data. The Christman AI Project never owns client data. Ever. All data is encrypted, client-controlled, and sovereignty-first by design.


© 2025–2026 The Christman AI Project. All Rights Reserved. Resonance-Q™ is a trademark of Everett Nathaniel Christman.

About

OpenSmell is an open-source olfactory engine mapping VOC chemical signatures to emotional and medical insights. By quantifying "leakage"—unscripted signals like stress-scents—it grounds empathy in reality. Part of a sovereign, ethical ecosystem, it provides restorative diagnostics while ensuring users own their data.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors