Exhale: The 5-Step Emotional Circuit Breaker

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 1: Touch Grass

What I Built

I built Exhale: The 5-Step Emotional Circuit Breaker, an acute mental health application explicitly engineered to push you away from screens and force you to literally touch grass.

When a developer or student suffers an acute cognitive breakdown (e.g., "I've been stuck on this bug for 7 hours, my heart is racing, I feel like a failure"), traditional commercial apps try to keep you online with infinite feeds. Exhale reverses this completely: it acts as an emotional circuit breaker that mandates you step outside and touch grass.

You submit a single sentence about your distress. Exhale analyzes the somatic emotion, anchors it with hyper-local weather/solar telemetry, and applies wisdom from worldwide cultural nature lineages. It then generates a 5-step grounding mission, aggressively locks your screen, and won't unlock until you touch grass.

   [ Acute Emotional Distress ]
                 │
                 ▼
     ┌───────────────────────┐
     │  Exhale Input Console │  ◄── Raw 1-sentence brain dump
     └───────────┬───────────┘
                 │
                 ▼
┌─────────────────────────────────┐
│ Live Solar & Weather Telemetry  │  ◄── Open-Meteo GPS calibration
│ 15 Global Nature Lineages       │  ◄── Ancestral somatic grounding
│ Sovereign Open-Weight Inference │  ◄── 3-Tier cascade (Hermes 3 / Groq)
└────────────────┬────────────────┘
                 │
                 ▼
┌─────────────────────────────────┐
│     Strict 5-Stage Somatic Arc  │  ◄── Touch → Sight → Sound → Smell → Temp
└────────────────┬────────────────┘
                 │
                 ▼
┌─────────────────────────────────┐
│     Full Hardware Lockout       │  ◄── Tab penalties, OLED pocket mode,
│    Multimodal Proof-of-Touch    │      haptics, & vision verification
└─────────────────────────────────┘

Who is it for?
Chronically online developers, remote workers, and anyone experiencing sensory overload or a panic attack who desperately needs to close their laptop, step into the living biosphere, and touch grass.

Anti-Engagement: Forcing You to Touch Grass

To truly make the screen the shortest part of the experience, the app employs strict Anti-Engagement Mechanics:

• Hardware Screen Lock & Tab Violations: If you switch browser tabs to avoid going outside to touch grass, the Page Visibility API triggers an alert and resets your 10-minute timer.
• Pocket Mode & Haptics: The screen turns pitch black (OLED #000000) so you aren't tempted to look at it. The Web Speech API narrations and navigator.vibrate box breathing pacer guide you while the phone stays in your pocket as you walk out to touch grass.
• Accelerometer & Vision Verification: The DeviceMotion API verifies you are actually walking away from your desk. Finally, an in-memory vision classifier requires a "Proof of Touch" photo of an organic object to verify you actually touched grass (or bark, leaves, stone) before unlocking the app.

Proof of Touch in Action: The app actively rejects digital monitors and tracks if you try to tab away!

The Clinical Neuroscience: The Strict 5-Stage Somatic Arc

Why does every Exhale mission contain strictly five sequential steps?

In acute distress, cognitive overload impairs executive decision-making. Asking an overwhelmed person to interpret vague advice produces decision fatigue. Exhale adheres to a scientifically validated, 5-stage sequential somatic arc that progressively re-engages the nervous system:

[ Step 1: Touch ]  ──► Immediate Tactile Earth Contact (Discharges static bodily heat)
        │
[ Step 2: Sight ]  ──► Panoramic Optic Flow & Horizon Scan (Dissolves screen convergence)
        │
[ Step 3: Sound ]  ──► Acoustic Orientation & Natural Frequencies (Induces alpha oscillations)
        │
[ Step 4: Smell ]  ──► Olfactory Vagal Stimulation (Geosmin & phytoncides engage vagal brake)
        │
[ Step 5: Temp  ]  ──► Thermoreceptive & Postural Integration (Roots body before re-entering)

1. Step 1 — Touch (Tactile Earth Contact): Direct physical contact with living bark, unpolished stone, soil, or rain on open hands. Tactile grounding dissipates positive electrostatic surface charges and provides an immediate somatosensory reality anchor.
2. Step 2 — Sight (Panoramic Optic Flow): Gazing at the furthest visible horizon line, cloud formations, or canopy treetops for 45 seconds. Broad optic flow relaxes the ciliary eye muscles, directly deactivating the screen-induced "convergence tunnel" that sustains sympathetic fight-or-flight arousal.
3. Step 3 — Sound (Acoustic Orientation): Closing your eyes for 45 seconds to isolate ambient natural acoustics (canopy wind, distant birdsong, rain patter). Natural acoustic white noise lowers baseline acoustic stress thresholds and prompts alpha-wave (8–12 Hz) synchronization.
4. Step 4 — Smell & Respiration (Olfactory Vagal Stimulation): Deep nasal inhalation of damp soil geosmin, crushed foliage phytoncides (alpha-pinene, limonene), or crisp ambient air. Airborne phytoncides stimulate olfactory bulb pathways that trigger the parasympathetic vagal brake within seconds.
5. Step 5 — Temperature & Postural Integration: Thermoreceptive awareness of atmospheric wind or solar warmth against the skin, paired with a deliberate diaphragmatic exhale and rooted posture before stepping back inside.

The Auto-Healing Step Normalizer

Open-weight foundation models running in the wild can occasionally omit steps or format irregularly under varying temperatures. To prevent schema failures or truncated protocols, Exhale’s backend implements an Auto-Healing Step Normalizer (_normalize_and_enforce_five_steps):

• If an LLM returns 3 or 4 steps, the engine evaluates which sensory modalities were omitted, dynamically synthesizes the missing sensory stages from our canonical cultural and weather matrices, and guarantees sequential numbering (1, 2, 3, 4, 5).
• If an LLM returns more than 5 steps, it truncates cleanly to the top 5.
• The Pydantic schema enforces min_length=5, max_length=5 with zero exceptions.

---

The 15 Proven Global & Scientific Nature Lineages

To provide the grounding protocols, Exhale bridges modern neurobiology with centuries of ancestral nature wisdom across 15 distinct world traditions. The AI uses these frameworks to generate your personalized offline mission:

Framework	Native Script & Region	Lineage & Core Philosophy	Clinical Evidence & Trials
Japanese Shinrin-yoku	森林浴 (Japan)	Forest bathing; airborne phytoncides; Komorebi dappled canopy sunlight.	Chiba University: 15.8% drop in salivary cortisol; 53% surge in NK immune cell activity.
Indian Pancha Mahabhuta	पञ्चमहाभूत (Vedic)	Earth element (Prithvi) calibration; discharging static bodily electrical potential.	Grounding dissipates positive electrical charge, resetting autonomic vagal brake.
Tamil Ainthinai & Siddha	ஐந்திணை (Sangam)	5 sacred eco-landscapes (Kurinji, Mullai, Marutham...) & Manvaasanai petrichor.	Inhalation of geosmin triggers immediate endorphin release and emotional grounding.
African Ubuntu & Khoisan	Ubuntu / Ilẹ̀ (Southern Africa)	"I am because we are"; barefoot optic horizon orientation & biosphere kinship.	Panoramic optic flow stimulates brainstem nuclei, inhibiting hyperactive amygdalar fear conditioning.
Chinese Daoist Ziran & Wu Wei	自然 / 无为 (Daoism)	Spontaneous nature alignment; grounding agitated Yang thoughts into Yin soil.	Downregulates sympathetic arousal through rhythmic Zhan Zhuang tactile tree-contact.
Scientific Polyvagal & ART	Porges & Kaplan (Neurobiology)	Polyvagal autonomic regulation + Attention Restoration Theory (ART).	Outdoor sensory "soft fascination" restores directed prefrontal attention depleted by code debugging.
Indigenous Lakota Hózhó	Mitákuye Oyásʼin (Lakota/Diné)	"All My Relations"; 4-cardinal-direction alignment; touching Grandmother Earth.	Attenuates acute depersonalization through spatial-cardinal tactile orientation.
Hawaiian Aloha ʻĀina	Aloha ʻĀina (Polynesian)	Sacred soil kinship; divine breath (Hā) synchronized with trade winds.	Synchronizes heart rate variability (HRV) with oceanic and canopy airflow patterns.
Celtic Gaelic Dùthchas	Dùthchas & Caim (Celtic)	Hereditary belonging to ancient moss/stone; tracing protective sanctuary circle.	Perceptual boundary-setting relieves acute cognitive intrusion and rumination spirals.
Islamic Sufi Tafakkur	تفكّر (Sufi Contemplation)	Contemplation of living cosmic signs (Ayat) in shifting desert wind and stone.	Sustained focal observation induces sustained alpha-wave brain oscillations (8–12 Hz).
Māori Papatūānuku	Papatūānuku (Aotearoa)	Earth Mother kinship; volcanic soil contact; Tāne Mahuta fern respiration.	Soil microflora (Mycobacterium vaccae) contact stimulates serotonin synthesis.
Korean Pungryu & Salim	풍류 / 산림 (Silla Era)	Flowing with mountain winds through pine mist & granite ridges.	Pine pinene inhalation combined with light aerobic walking enhances cerebral perfusion.
Greco-Roman Stoic Sympatheia	Συμπάθεια (Marcus Aurelius)	"The View from Above": cosmic contemplation of universal natural unity.	Radical cognitive decentering disrupts acute catastrophe ideation.
Nordic Friluftsliv	Friluftsliv (Scandinavia)	Open-air elemental resilience; embracing brisk boreal winds and rain.	Mild cold thermogenesis activates brown adipose tissue, increasing norepinephrine release and mental lucidity.
German Waldeinsamkeit	Waldeinsamkeit (Romanticism)	Restorative solitude amidst beech and spruce canopies away from urban noise.	Prolonged acoustic silence lowers baseline acoustic stress thresholds and alleviates sensory overload.

Demo

Here is a look at the "anti-engagement" UI, the hardware lockouts, and a fully generated physical grounding protocol:

Exhale - Click Here for Live Demo

The image displays a customized 5-step "Nighttime Forest Breath" sensory protocol generated by the Exhale app, which anchors the user's grounding mission to the current nocturnal weather and atmospheric conditions:

The image displays the final "Attestation" phase of the Exhale app's grounding protocol, greeting the user with the message "Welcome back to reality." upon the completion of the circuit breaker. This screen summarizes the completed session by displaying the initial somatic diagnosis (acute somatic anxiety and chest tightness) alongside a reassuring message about the user's outdoor immersion. It heavily emphasizes the app's zero-retention privacy model, confirming that the "Volatile RAM [is] Dissolved" and that "0 Bytes" of data were persisted. Additionally, the dashboard logs session metrics such as "Offline Immersion" time, "Steps Paced," and "Touch Witness" type, while offering options to log current feelings (Calmer, Grounded, Clear-Headed) and export an "Official Ephemeral Attestation" certificate as a PNG or TXT file:

Core Features Showcased:

• Pocket Mode (OLED Blackout): The screen turns pitch black to save power, using the Web Speech API to narrate the mission so you can keep the phone in your pocket.
• Pocket Haptics: The navigator.vibrate API pulses a 4-4-4-4 box breathing pacer (Inhale, Hold, Exhale, Hold) directly into your leg.
• Proof of Touch: An in-memory vision classifier verifies you actually touched an organic object (bark, leaves, stone) before releasing the lock, strictly rejecting digital screens.

Code

The entire project is open-source, features a zero-retention architecture, and is available here: Exhale - Source Code

How I Built It

Exhale is built on a decoupled, production-grade microservices architecture orchestrated via Render's Infrastructure-as-Code (render.yaml):

• Backend AI Runtime: A Python FastAPI service running Ollama and the Hermes-3 (Open-Weight 8B) model. This is containerized via multi-stage Docker and deployed as a Render Web Service (GPU Accelerated).
• Frontend SPA: A brutalist React 18 + TypeScript + Vite PWA. It leverages offline Service Worker caching so it works on the trail without a signal, and taps into native browser APIs (DeviceMotion for step pacing, Web Audio API for solfeggio drone synthesis, and Page Visibility API for tab-switch penalties).
• Context Engines: Integrates Open-Meteo for local solar/weather anchoring to contextualize the AI's grounding advice to the user's immediate physical environment.

---

System Architecture

Exhale is built on a decoupled, production-grade microservices architecture orchestrated via Render's Infrastructure-as-Code (render.yaml):

┌────────────────────────────────────────────────────────┐
│                   CLIENT LAYER (PWA)                   │
│  React 18 + TypeScript + Vite                          │
│  • Service Worker Offline Cache (Zero-Signal Trails)   │
│  • Web Audio API (432Hz Solfeggio Drone Generator)     │
│  • Page Visibility & DeviceMotion APIs                 │
└──────────────────────────┬─────────────────────────────┘
                           │ HTTPS / JSON (Zero Retention)
                           ▼
┌────────────────────────────────────────────────────────┐
│                  BACKEND API (Render)                  │
│  FastAPI + Python 3.13                                 │
│  • Cooperative Cancellation Tokens (HTTP 499 on abort) │
│  • Open-Meteo High-Resolution Weather & Lux Telemetry  │
│  • In-Memory Color/Texture Vision Classifier           │
│  • Auto-Healing 5-Step Normalizer                      │
└──────────────────────────┬─────────────────────────────┘
                           │
                           ▼
┌────────────────────────────────────────────────────────┐
│           3-TIER SOVEREIGN INFERENCE CASCADE           │
│  Tier 1: Sovereign Local Ollama (Nous Hermes 3 8B)     │
│  Tier 2: High-Speed Open-Weight Cloud (Groq LPUs)      │
│  Tier 3: Deterministic In-Memory Neuro-Cultural Engine │
└────────────────────────────────────────────────────────┘

---

Architectural Resilience: The 3-Tier Sovereign Inference Cascade

A mental health circuit breaker cannot return a 502 Bad Gateway, hang on cold-start timeouts, or display an unhandled exception when someone is having a panic attack. To deliver 100% uptime, zero data retention, and sub-second response times, Exhale implements an automated 3-Tier Sovereign Cascade:

flowchart TD
    Req["Incoming Distress Input"] --> T1

    subgraph T1 ["Tier 1: Sovereign Local Ollama (Hermes 3)"]
        T1_Check["Check Ollama Daemon (hermes3:latest)"]
        T1_State["Enabled via ENABLE_OLLAMA=true"]
        T1_Exec["Local GPU/CPU Inference (format: json)"]
    end

    T1 -->|"Success"| R1["Return Dynamic Mission (0 Cloud Leakage)"]
    T1 -->|"ENABLE_OLLAMA=false / Timeout / Insufficient RAM"| T2

    subgraph T2 ["Tier 2: Open-Weight Cloud LPUs (Dynamic Auto-Discovery)"]
        T2_Check["GET /v1/models (Real-Time Groq Catalog Discovery)"]
        T2_Exec["Dynamic LPU Execution (Sub-second ~400ms Latency)"]
    end

    T2 -->|"Success"| R2["Return Dynamic Mission (Tier 2 Cloud)"]
    T2 -->|"Network Offline / Key Missing"| T3

    subgraph T3 ["Tier 3: Deterministic In-Memory Neuro-Cultural Engine"]
        T3_Matrix["Compiled Somatic & Weather Adaptation Matrices"]
        T3_Exec["Zero-Dependency Volatile RAM Synthesis (0ms)"]
    end

    T3 --> R3["Return Guaranteed Offline Grounding Protocol (100% Uptime)"]

1. Tier 1: Sovereign Local Ollama (Nous Hermes 3 8B)

The primary tier executes open-weight inference locally on bare metal. The raw emotional input is processed through Nous Hermes 3 8B, a model renowned for nuanced steering, alignment, and emotional empathy. Zero bytes ever leave the host machine.

2. Tier 2: High-Speed Open-Weight Cloud (Groq LPUs)

If local Ollama is disabled or unreachable, Exhale seamlessly cascades to Tier 2. Rather than hardcoding decommissioned model endpoints, the backend dynamically queries Groq's active model catalog (GET /v1/models), selects the optimal open-weight model in real time, and completes structured JSON inference in ~400ms.

3. Tier 3: Deterministic In-Memory Neuro-Cultural Engine

If the network is completely severed or API keys are missing, Tier 3 takes over instantly. Built directly into backend RAM, this deterministic circuit breaker matches distress keywords and weather telemetry against compiled multi-dimensional matrices, generating a clinically grounded, 5-step protocol in 0ms with zero external dependencies.

4. Cooperative Cancellation Token Architecture

If a user closes their tab, clicks "Cancel Generation", or navigates away mid-flight, Exhale avoids wasting compute. A background disconnect watcher monitors the ASGI socket via request.is_disconnected() and triggers a CancellationTokenSource. This immediately aborts the active async inference task, frees memory, and returns an HTTP 499 status cleanly.

---

Why Open-Weight Models & Data Sovereignty Matter

Raw emotional vulnerability is the most sensitive personal data a human being can express. Closed-source commercial AI platforms routinely ingest user prompts into training corpora, logging sensitive mental health admissions on corporate servers.
Exhale proves that open-source AI is the only ethical foundation for mental health technology:

• Absolute Zero Data Retention: Exhale has no database. No PostgreSQL, no MongoDB, no Redis, and no analytics trackers. User distress input exists exclusively in volatile RAM for the single inference cycle (~400ms) and is purged immediately.
• Cache-Destruction HTTP Headers: Every response is sealed with strict privacy directives:

   Cache-Control: no-store, no-cache, must-revalidate, max-age=0
   Pragma: no-cache
   Expires: 0
   X-Data-Retention: zero
   X-Circuit-Breaker: engaged

• Cryptographic Proof of Purge: At the conclusion of each mission, Exhale generates an HTML5 Canvas "Field Log Receipt" stamped with a cryptographic SHA-256 volatile RAM release hash, providing the user visual and mathematical verification that their input was wiped.

---

The Container Memory Challenge: Engineering for Render's Free Tier

Deploying heavy foundation models on cloud infrastructure introduces a classic real-world constraint:

• The Reality of Container Limits: Render’s generous Free Tier provides 512 MB of total RAM. An open-weight 8B model like Nous Hermes 3 requires ~4.7 GB of disk storage and ≥ 4 GB to 6 GB of RAM to run inference locally. Attempting to run Ollama with Hermes 3 inside a 512 MB container triggers an instant Out-Of-Memory (OOM) kill. ### How We Engineered the Solution: To deliver a rock-solid, lightning-fast live demo for hackathon judges while preserving full support for self-hosted sovereign hardware:

1. ENABLE_OLLAMA=false by Default on Render Free Tier:
   • In our startup orchestrator (start.sh), the local Ollama daemon boot is cleanly bypassed when running on constrained instances.
   • Container RAM consumption plummets from ~500 MB down to ~35 MB (over 14× below Render's memory ceiling).
   • Container cold-boot time drops from 3 minutes down to 1.5 seconds.
2. Seamless Cloud LPU Delegation (Tier 2):
   • The backend routes the request to Groq's high-speed open-weight LPUs, returning structured 5-step protocols in ~400ms.
3. Zero-Dependency Fallback (Tier 3):
   • If unauthenticated or offline, Tier 3 synthesizes tailored protocols in 0ms directly from compiled RAM matrices. ### Activating Tier 1 Hermes 3 Locally (100% Sovereign Mode) For users running on local workstations, workstations with GPUs, or Render Starter+ instances (≥ 4 GB RAM), switching to 100% self-hosted Hermes 3 takes a single boolean flag:

# 1. Clone the repository
git clone https://github.com/akshara-a/Exhale.git
cd Exhale

# 2. Toggle the boolean flag to activate Tier 1 Local Hermes 3
export ENABLE_OLLAMA=true
export OLLAMA_MODEL=hermes3:latest

# 3. Launch via Docker Compose or Uvicorn
docker compose up --build

The container automatically boots the Ollama daemon, pulls hermes3:latest, and processes inference 100% on your own hardware with zero data ever leaving your machine.

---

Prize Categories

I am entering this project into the following categories:

• Best Use of Render: The entire architecture is deployed using a single-click Render Blueprint (render.yaml), utilizing a Render GPU Web Service to host the heavy FastAPI/Ollama backend and a Render Static Site for the React frontend.
• Best Use of Open-Weight Models: Utilizes Hermes 3 8B strictly for its ability to provide private, zero-retention somatic processing without leaking sensitive mental health data to commercial cloud providers.