<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Ishita Singh</title>
    <description>The latest articles on DEV Community by Ishita Singh (@ish1416).</description>
    <link>https://dev.to/ish1416</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4152815%2F55a9632f-f821-4d8a-9312-838612999bd9.png</url>
      <title>DEV Community: Ishita Singh</title>
      <link>https://dev.to/ish1416</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/ish1416"/>
    <language>en</language>
    <item>
      <title>Our Ancestors Do Not Belong to an API: I Built an Air-Gapped Digital Ofrenda with Gemma 🕯️🌼</title>
      <dc:creator>Ishita Singh</dc:creator>
      <pubDate>Fri, 30 Oct 2026 17:16:32 +0000</pubDate>
      <link>https://dev.to/ish1416/our-ancestors-do-not-belong-to-an-api-i-built-an-air-gapped-digital-ofrenda-with-gemma-20ja</link>
      <guid>https://dev.to/ish1416/our-ancestors-do-not-belong-to-an-api-i-built-an-air-gapped-digital-ofrenda-with-gemma-20ja</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for the &lt;a href="https://dev.to/challenges/hacktoberfest-week4-2026-10-26"&gt;Hacktoberfest Open-Source AI Challenge Week 4: Ghost in the Machine&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fyrxnut5eqnt8y9frty8y.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fyrxnut5eqnt8y9frty8y.jpg" alt="Ofrenda Living Altar" width="800" height="447"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;🌼 &lt;strong&gt;Try it live:&lt;/strong&gt; &lt;a href="https://ofrenda-living-altar.onrender.com" rel="noopener noreferrer"&gt;&lt;strong&gt;ofrenda-living-altar.onrender.com&lt;/strong&gt;&lt;/a&gt; · 📦 &lt;strong&gt;Code:&lt;/strong&gt; &lt;a href="https://github.com/ish1416/ofrenda" rel="noopener noreferrer"&gt;github.com/ish1416/ofrenda&lt;/a&gt;&lt;br&gt;
&lt;em&gt;(Hosted on Render's free tier, so the first load after a quiet spell can take ~50 seconds to wake up. Worth the wait. Light a candle.)&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;"No me llores, no, porque si lloras yo peno.&lt;/em&gt;&lt;br&gt;&lt;br&gt;
&lt;em&gt;En cambio si tú me cantas yo siempre vivo y nunca muero."&lt;/em&gt;&lt;br&gt;&lt;br&gt;
— Traditional Mexican Folk Hymn, &lt;em&gt;La Llorona&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;




&lt;h2&gt;
  
  
  🕯️ The Raw Truth: Why Grief is Not a SaaS Metric
&lt;/h2&gt;

&lt;p&gt;Last November, my family gathered around our kitchen table with a battered cardboard shoebox tied with fraying twine. Inside was everything my late grandmother, &lt;strong&gt;Elena Ramirez Solis (1938–2021)&lt;/strong&gt;, had left behind: a faded Paracho acoustic guitar with worn cedar frets, an old TDK C-60 cassette tape from 1975 labeled &lt;em&gt;"La Llorona y canciones de Oaxaca"&lt;/em&gt;, and a yellowed recipe card for her legendary Mole Negro, handwritten in fading fountain pen ink with chocolate stains along the edges.&lt;/p&gt;

&lt;p&gt;We wanted to preserve her voice, her kitchen secrets, and her oral histories for her great-grandchildren who would never get to sit on her lap. So I did what any developer would do: I researched modern "AI memorial" and "grief tech" platforms.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;What I found felt like a modern desecration.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Every commercial startup in the space operated on the exact same predatory playbook:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;The $19.99/Month Subscription Toll on Grief&lt;/strong&gt;: If you want your child to hear their great-grandmother’s laugh, you have to keep your credit card active on Stripe. If your card expires, or you fall on hard times, your loved one’s digital presence is locked behind a paywall.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Proprietary Data Extraction&lt;/strong&gt;: To build these synthetic chatbots, you must upload your loved one's intimate handwritten letters, voice memos, and deathbed confessions to a closed corporate cloud. Their terms of service quietly grant them the right to train next-generation models on your most vulnerable family memories.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The Bankruptcy Erasure Risk&lt;/strong&gt;: When a venture-backed grief startup runs out of runway and shuts its servers down, your family archive evaporates into the ether with a 404 error.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;In Mexican tradition, &lt;strong&gt;Día de los Muertos (November 1 &amp;amp; 2)&lt;/strong&gt; is not a morbid Halloween spectacle of jump-scares or haunted machines. It is a sacred metaphysical bridge. In Mesoamerican philosophy, a person experiences three deaths:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;The physical death when the breath leaves the body.&lt;/li&gt;
&lt;li&gt;The burial when the body returns to the earth.&lt;/li&gt;
&lt;li&gt;The final death (&lt;em&gt;el olvido&lt;/em&gt;) when there is no one left in the living world who remembers your name.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;As long as an ofrenda is raised, candles are lit, and memories are shared aloud, our departed ancestors are never gone. &lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Our ancestors do not belong to an API. Grief is not a SaaS metric. Memory must be sovereign, permanent, and free.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;For the final Hacktoberfest challenge, I built &lt;strong&gt;Ofrenda&lt;/strong&gt;: an open-source, air-gapped living digital altar, 3D celestial cosmos, and oral history memory vault powered by Google’s open-weight &lt;strong&gt;Gemma&lt;/strong&gt; model. It runs entirely on your own laptop with the Wi-Fi switched off, the curtains drawn, and candles flickering.&lt;/p&gt;




&lt;h2&gt;
  
  
  🌼 The Living Altar Architecture
&lt;/h2&gt;

&lt;p&gt;&lt;em&gt;Ofrenda&lt;/em&gt; translates the sacred architecture of the traditional three-tier altar into a tactile, living browser sanctuary backed by local open-weight AI and procedural Web Audio:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;                                ┌───────────────────────────────────────┐
                                │          TIER 1: EL CIELO             │
                                │   - Antique Portrait &amp;amp; 4 Candles      │
                                │   - Cerillos La Central Match Physics │
                                │   - Camino de Cempasúchil &amp;amp; Footsteps │
                                │   - 3D Celestial Cosmos of Souls      │
                                │   - Interactive Sahumerio de Copal    │
                                └───────────────────┬───────────────────┘
                                                    │
                     ┌──────────────────────────────┴──────────────────────────────┐
                     │                                                             │
      ┌──────────────┴──────────────┐                               ┌──────────────┴──────────────┐
      │      TIER 2: LA TIERRA      │                               │     TIER 3: LA MEMORIA      │
      │ - 3D Recipe Card (Flip)     │                               │ - Sacred Letter Burning     │
      │ - 1975 Cassette Player      │                               │ - Gemma Chronicler Console  │
      │ - Radio Fantasma Shortwave  │                               │ - 3D Lotería de Recuerdos   │
      │ - P31 Phosphor Oscilloscope │                               │ - Calaveritas Literarias    │
      │ - Sugar Skull Symmetry Canvas│                              │ - Sovereign Altar Dedication│
      │ - 6-Track Acoustic Console  │                               │ - High-Res Altar Share Poster│
      └─────────────────────────────┘                               └─────────────────────────────┘
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  🌟 The 12 Flagship Interactive Systems
&lt;/h2&gt;
&lt;h3&gt;
  
  
  1. 🕯️ Tactile Drag-and-Strike Match Physics (&lt;code&gt;match.js&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;Instead of boring button clicks, lighting candles requires striking a wooden match against a vintage box of &lt;strong&gt;Cerillos La Central&lt;/strong&gt; (Classics of Mexico):&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Dynamic Friction Velocity&lt;/strong&gt;: Dragging the matchstick across the textured sandpaper strip measures cursor acceleration.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Spark Particle Emitter&lt;/strong&gt;: Only striking above a velocity threshold ignites real-time incandescent sparks with randomized gravity and air resistance.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Dynamic Flame Physics&lt;/strong&gt;: Dragging the burning matchstick draws a turbulent flame trail with smoke wisps that responds to mouse velocity.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Collision Detection&lt;/strong&gt;: Hovering the burning match over any unlit beeswax candle ignites its wick, accompanied by procedural match-hiss and a resonant candle bloom ring!&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  2. 🌼 Camino de Cempasúchil &amp;amp; Footprints of the Ánimas (&lt;code&gt;camino.js&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;In authentic Mexican tradition, scattering golden cempasúchil (twenty-petaled marigolds) is the most ancient ritual of Día de los Muertos, guiding traveling souls from Mictlán directly to the altar:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Interactive Petal Scatter&lt;/strong&gt;: Drag or click across the pathway to sprinkle golden cempasúchil petals with individual 3D gradient shading (marigold gold, sunburst yellow, deep saffron orange), organic rotational tilt, and glowing pollen dust.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;1-Click "Sembrar Camino Sagrado"&lt;/strong&gt;: Automatically weaves a dense, undulating S-curve petal carpet leading from the doorstep to the altar.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;"Invocar Huellas de las Ánimas"&lt;/strong&gt;: An ethereal ritual where faint, glowing golden ancestral footsteps (&lt;em&gt;huellas doradas&lt;/em&gt;) appear one by one along the petal path. When the footsteps reach the top, Elena's portrait pulses with a warm celestial aura, and harmonic bells ring out!&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  3. 🌺 Sovereign Family Altar Personalization (&lt;code&gt;dedication.js&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;"Our ancestors do not belong to an API." Any family in the world can make this altar their own:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Re-dedicate the altar to any departed ancestor (parent, grandparent, sibling, friend).&lt;/li&gt;
&lt;li&gt;Upload a custom family photo or select traditional portrait styling, customize their birth/passing years, and memorial quotes.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;100% Sovereign Air-Gapped Persistence&lt;/strong&gt;: All family memories, photos, and dedications are saved locally in the browser (&lt;code&gt;localStorage&lt;/code&gt;). Zero bytes leave your machine.&lt;/li&gt;
&lt;li&gt;The &lt;strong&gt;Gemma Chronicler&lt;/strong&gt; dynamically adopts your ancestor's name and biographical facts, allowing you to converse with your own family's preserved history.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  4. ✨ 3D Celestial Constellation of Souls (&lt;code&gt;constellation.js&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;In pre-Hispanic cosmology, souls reside in the starry expanse of &lt;em&gt;Mictlān&lt;/em&gt; and the celestial vaults:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Interactive 3D Sphere&lt;/strong&gt;: Spherical coordinates &lt;code&gt;(r, θ, φ)&lt;/code&gt; are mathematically projected to 2D Cartesian screen coordinates via 3D rotation matrices, creating a rotating celestial sphere of ancestor stars with full mouse orbit drag controls.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Ancestral Tooltips&lt;/strong&gt;: Hovering over any star reveals their name, dates, and legacy quote in a glassmorphic card.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Elevate a Soul&lt;/strong&gt;: Visitors can click &lt;strong&gt;+ Elevar un Alma a las Estrellas&lt;/strong&gt; to enshrine their own beloved ancestor into the eternal constellation.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  5. 💨 Interactive Copal Sahumerio &amp;amp; Smoke Fluid Physics (&lt;code&gt;copal.js&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;In Tier 1, an authentic pre-Hispanic clay incense burner (&lt;em&gt;sahumerio&lt;/em&gt;) smolders with sacred white copal resin from Oaxaca:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Fluid Smoke Physics&lt;/strong&gt;: Billowing, semi-translucent smoke spirals rise with natural buoyancy and curling turbulence.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Mouse Fanning Interaction&lt;/strong&gt;: Moving your mouse through the smoke acts as a hand fanning the incense—smoke particles react to cursor velocity with realistic vortex displacement!&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Sacred Purification Blessing&lt;/strong&gt;: Clicking the burner adds fresh copal resin, releasing an aromatic smoke plume and triggering a golden purification aura across Elena's portrait.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  6. 📺 CRT Phosphor Oscilloscope &amp;amp; Lissajous Visualizer (&lt;code&gt;oscilloscope.js&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;Mounted beside the vacuum-tube spirit radio, a vintage &lt;strong&gt;P31 Green Phosphor CRT Oscilloscope&lt;/strong&gt; visualizes the electronic frequencies of the spirit realm:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;60 FPS Phosphor Decay Persistence&lt;/strong&gt;: Mimics authentic cathode-ray tube phosphor afterglow with scanline raster lines and circular reticle graticules.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;3 Visualizer Modes&lt;/strong&gt;:

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;Lissajous&lt;/code&gt;: Dual-sine parametric harmonic curves reacting to frequency interference.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;Onda&lt;/code&gt;: Real-time time-domain audio waveform with variable time-base division.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;Espectro&lt;/code&gt;: FFT frequency spectrum bars displaying voice harmonics.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  7. 🎨 Calaverita de Azúcar Symmetry Painter Studio (&lt;code&gt;painter.js&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;A full digital artisan canvas allowing visitors to decorate traditional sugar skulls:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Bilateral Real-Time Mirroring&lt;/strong&gt;: Drawing on one side of the skull automatically mirrors across the central cranial axis (&lt;code&gt;symX = cx + (cx - x)&lt;/code&gt;), ensuring perfect Mexican folk symmetry.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;6 Artisanal Palettes&lt;/strong&gt;: Cempasúchil Gold, Bougainvillea Magenta, Oaxaca Jade, Sky Turquoise, Amethyst Violet, and Deep Obsidian.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;3 Brush Dynamics&lt;/strong&gt;: Royal Icing Line, Petal Flower Stamp, and Sugar Dots.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;1-Click Altar Placement&lt;/strong&gt;: Tap &lt;strong&gt;Colocar en Altar&lt;/strong&gt; to consecrate your painted calavera directly onto the living ofrenda stage with a golden flower burst!&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  8. 🎚️ 6-Track Procedural Acoustic Soundscape Console (&lt;code&gt;mixer.js&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;A master studio acoustic mixer synthesizing traditional Día de los Muertos soundscapes natively with Web Audio:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Track 1: Velas &amp;amp; Fuego&lt;/strong&gt;: Organic candle crackle and warm thermal hum.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Track 2: Lluvia Tejas&lt;/strong&gt;: Soft autumn drizzle pattering against clay roof tiles.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Track 3: Paracho Acústica&lt;/strong&gt;: Authentic nylon-string guitar arpeggios of &lt;em&gt;La Llorona&lt;/em&gt; in D minor.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Track 4: Viento Copal&lt;/strong&gt;: Low-frequency resonant wind modulated by a 0.08 Hz LFO.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Track 5: Campanas Catedral&lt;/strong&gt;: Deep cathedral church bells with long exponential decay rings.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Track 6: Grillos Oaxaca&lt;/strong&gt;: Nocturnal crickets chirping in peaceful garden rhythms.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Live Studio Features&lt;/strong&gt;: Vertical fader controls, individual channel mutes, Master VU meter with dynamic LED peaking, and 3 one-click presets (&lt;em&gt;Vigilia&lt;/em&gt;, &lt;em&gt;Lluvia Coyoacán&lt;/em&gt;, &lt;em&gt;Paz Sagrada&lt;/em&gt;).&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  9. 📻 Radio Fantasma: Shortwave Spirit Transceiver
&lt;/h3&gt;

&lt;p&gt;An analog vintage tube radio widget (12AX7 vacuum-tube glow) allowing visitors to slide across historical frequencies from 1938 to 2026:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;540 kHz (1938)&lt;/strong&gt;: &lt;em&gt;Oaxaca Mountain Valley&lt;/em&gt; — Elena as a young girl learning to grind corn on the metate while her grandmother hums a Mixtec lullaby.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;700 kHz (1958)&lt;/strong&gt;: &lt;em&gt;Arrival in Coyoacán&lt;/em&gt; — The hiss of the bus brakes at Plaza Hidalgo with two cardboard suitcases and 15 pesos in her rebozo.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;950 kHz (1966)&lt;/strong&gt;: &lt;em&gt;Plaza de Santo Domingo&lt;/em&gt; — The brass band playing &lt;em&gt;Dios Nunca Muere&lt;/em&gt; while the chile chilhuacle roasted over wood smoke.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;1200 kHz (1975)&lt;/strong&gt;: &lt;em&gt;Under the Jacarandas&lt;/em&gt; — Tuning her Paracho guitar to record &lt;em&gt;La Llorona&lt;/em&gt; on tape with her sisters laughing in the background.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;1400 kHz (1982)&lt;/strong&gt;: &lt;em&gt;The Kitchen Table&lt;/em&gt; — Her immortal family law: &lt;em&gt;"Nadie levanta la voz donde hay pan calientito. Coman primero, perdónense después."&lt;/em&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;1600 kHz (2026)&lt;/strong&gt;: &lt;em&gt;Gemma Spirit Frequency&lt;/em&gt; — An ethereal transmission: &lt;em&gt;"Los muertos solo mueren cuando se les olvida. Mientras tú me recuerdes con alegría, aquí estaré a tu lado."&lt;/em&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  10. ✉️ Quemar Carta a las Ánimas (Sacred Memory Ritual)
&lt;/h3&gt;

&lt;p&gt;Visitors can write an unsaid remembrance, secret message, or gratitude to Elena or their departed loved ones:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Amber Incineration&lt;/strong&gt;: The parchment visually catches fire, burning from bottom to top with realistic glowing embers.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Procedural Sound&lt;/strong&gt;: Procedural Web Audio synthesizes realistic paper crackle and rising flame whoosh.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Gemma Ancestral Blessing&lt;/strong&gt;: Local &lt;strong&gt;Gemma&lt;/strong&gt; receives the words through the rising smoke and composes an intimate, maternal ancestral blessing (&lt;em&gt;Bendición de las Ánimas&lt;/em&gt;), reassuring the sender that love transcends physical separation.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  11. 🃏 Lotería de los Recuerdos: Cartas de Sabiduría (&lt;code&gt;loteria.js&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;An authentic interactive deck of 8 Mexican folk Lotería memory cards on the altar:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;3D Card Flip&lt;/strong&gt;: Clicking any card flips it with 3D perspective and tactile paper whoosh audio.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cultural Wisdom&lt;/strong&gt;: Cards include &lt;em&gt;La Calavera&lt;/em&gt;, &lt;em&gt;El Cempasúchil&lt;/em&gt;, &lt;em&gt;El Pan de Muerto&lt;/em&gt;, &lt;em&gt;La Guitarra&lt;/em&gt;, &lt;em&gt;El Corazón&lt;/em&gt;, &lt;em&gt;El Copal&lt;/em&gt;, &lt;em&gt;La Luna&lt;/em&gt;, and &lt;em&gt;El Metate&lt;/em&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Gemma Oracle Consultation&lt;/strong&gt;: Click &lt;strong&gt;Pedir Consejo a Abuela Elena&lt;/strong&gt; to have local Gemma interpret the drawn card as an oracle for your current life challenges!&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  12. 🕯️ Vigilia Sagrada: Noche de Muertos (&lt;code&gt;vigil.js&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;Clicking &lt;strong&gt;🕯️ Entrar en Vigilia&lt;/strong&gt; transforms the experience into a midnight candlelit cemetery:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Volumetric Lantern Spotlight&lt;/strong&gt;: The entire interface dims into pitch black midnight, and an interactive radial lantern spotlight smoothly follows your cursor like holding a brass lantern in the dark!&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Dynamic Candle Light Cutouts&lt;/strong&gt;: Real-time radial illumination punch-outs reveal the glowing candles and Elena's portrait through the darkness.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Atmospheric Transition&lt;/strong&gt;: Cross-fades the acoustic mixer into nocturnal crickets and distant cathedral bells.&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  🎨 High-Resolution Altar Poster Generator &amp;amp; Virality Engine (&lt;code&gt;share.js&lt;/code&gt;)
&lt;/h2&gt;

&lt;p&gt;Clicking &lt;strong&gt;✨ Compartir Ofrenda&lt;/strong&gt; opens the viral commemorative poster generator:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;1200x800 HTML5 Canvas Rendering&lt;/strong&gt;: Combines the user's custom-painted calavera, lit candle count, ancestor tribute, and Elena's sacred quote inside an ornate baroque golden filigree frame with Mexican rosettes.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;1-Click High-Res PNG Download&lt;/strong&gt;: Exports an archival-grade image to save or print.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;1-Click Social Sharing&lt;/strong&gt;: Pre-configured share hooks for &lt;strong&gt;X (Twitter)&lt;/strong&gt;, &lt;strong&gt;LinkedIn&lt;/strong&gt;, and &lt;strong&gt;DEV.to&lt;/strong&gt; with hashtags &lt;code&gt;#Hacktoberfest2026 #DiaDeLosMuertos #GemmaAI #OpenSourceAI&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  🚀 Live Demo &amp;amp; Open Source Code
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;🌐 Live Demo (Render):&lt;/strong&gt; &lt;a href="https://ofrenda-living-altar.onrender.com" rel="noopener noreferrer"&gt;https://ofrenda-living-altar.onrender.com&lt;/a&gt;
&lt;em&gt;Free tier: the first visit after idle time takes ~50 seconds to wake up. The hosted demo runs in &lt;code&gt;DEMO_MODE&lt;/code&gt;, so Gemma's replies come from built-in demo responses; the altar, animations, audio and every ritual are fully interactive.&lt;/em&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;📦 Official GitHub Repository (Permissive MIT License):&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;
&lt;div class="ltag-github-readme-tag"&gt;
  &lt;div class="readme-overview"&gt;
    &lt;h2&gt;
      &lt;img src="https://assets.dev.to/assets/github-logo-5a155e1f9a670af7944dd5e12375bc76ed542ea80224905ecaf878b9157cdefc.svg" alt="GitHub logo"&gt;
      &lt;a href="https://github.com/ish1416" rel="noopener noreferrer"&gt;
        ish1416
      &lt;/a&gt; / &lt;a href="https://github.com/ish1416/ofrenda" rel="noopener noreferrer"&gt;
        ofrenda
      &lt;/a&gt;
    &lt;/h2&gt;
    &lt;h3&gt;
      
    &lt;/h3&gt;
  &lt;/div&gt;
  &lt;div class="ltag-github-body"&gt;
    
&lt;div id="readme" class="md"&gt;&lt;div class="markdown-heading"&gt;
&lt;h1 class="heading-element"&gt;🌼 Ofrenda: Living Digital Altar &amp;amp; Oral History Vault&lt;/h1&gt;
&lt;/div&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Honoring Ancestral Memory with Air-Gapped Open-Weight AI (Google Gemma 2)&lt;/strong&gt;&lt;br&gt;
&lt;em&gt;Winner-Caliber Submission for the Hacktoberfest Open-Source AI Challenge: Week 4 — Ghost in the Machine&lt;/em&gt;&lt;br&gt;
Permissive MIT License • 100% Offline Capable • Privacy-Preserving • Zero Audio Sample Dependencies&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;&lt;a rel="noopener noreferrer" href="https://github.com/ish1416/ofrenda/static/assets/hero_altar.jpg"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fraw.githubusercontent.com%2Fish1416%2Fofrenda%2FHEAD%2Fstatic%2Fassets%2Fhero_altar.jpg" alt="Ofrenda Altar"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href="https://fastapi.tiangolo.com" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/41637ead3df8cf2e2f6589f103ec2d5c92edd0f0a7fbbf81d287aeaed09807c1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f466173744150492d302e3131352b2d3030393638382e7376673f6c6f676f3d66617374617069266c6f676f436f6c6f723d7768697465" alt="FastAPI"&gt;&lt;/a&gt;
&lt;a href="https://ai.google.dev/gemma" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/329ec8c4524295098007240886af163bc252417f32ffb0927768b51c383207fb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f41492532304d6f64656c2d476f6f676c6525323047656d6d61253230322532302832422532302532462532303942292d3432383546342e7376673f6c6f676f3d676f6f676c65266c6f676f436f6c6f723d7768697465" alt="Google Gemma 2"&gt;&lt;/a&gt;
&lt;a href="https://opensource.org/licenses/MIT" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667" alt="License: MIT"&gt;&lt;/a&gt;
&lt;a href="https://github.com/ish1416/ofrenda/tests/" rel="noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/4fee1967c27fabd81fba211e98af42fa70965c21c101c22086fa7250f25b2a00/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f54657374732d392532305061737365642d737563636573732e737667" alt="Tests Passing"&gt;&lt;/a&gt;
&lt;a href="https://ofrenda-living-altar.onrender.com" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/0929cdac146b2adc299e38ab5b29683fc64859e4df37f73f82fdaee9a53971bb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c69766525323044656d6f2d6f6672656e64612d2d6c6976696e672d2d616c7461722e6f6e72656e6465722e636f6d2d3436453342372e7376673f6c6f676f3d72656e646572266c6f676f436f6c6f723d7768697465" alt="Live Demo"&gt;&lt;/a&gt;
&lt;a href="https://render.com/deploy?repo=https://github.com/ish1416/ofrenda" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/c3053e93bc9f0a2cd84050a5ff9f07cc5e639621a72e50dce48781f4a38f10e2/68747470733a2f2f72656e6465722e636f6d2f696d616765732f6465706c6f792d746f2d72656e6465722d627574746f6e2e737667" alt="Deploy to Render"&gt;&lt;/a&gt;
&lt;a href="https://dev.to/challenges/hacktoberfest-week4-2026-10-26" rel="nofollow"&gt;&lt;img src="https://camo.githubusercontent.com/3cf818e07d9f94a7603138cc5813babaea1f653038e597533bdd16efd7762c27/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4445562d4861636b746f626572666573742532305765656b253230342d626c61636b2e7376673f6c6f676f3d646576646f74746f266c6f676f436f6c6f723d7768697465" alt="DEV Challenge"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;💡 The Philosophy: Why Grief is Not a SaaS Product&lt;/h2&gt;
&lt;/div&gt;
&lt;p&gt;Every year during &lt;strong&gt;Día de los Muertos (November 1–2)&lt;/strong&gt;, families gather across Latin America to build &lt;em&gt;ofrendas&lt;/em&gt;—traditional multi-tiered altars honoring deceased loved ones with candlelight, cempasúchil (marigolds), copal incense, and favorite meals.&lt;/p&gt;
&lt;p&gt;Recently, closed commercial "AI memorial" apps have emerged, charging $20/month subscriptions to create chatbot avatars of departed family members. These proprietary services require uploading private family letters, photos, and voice notes to closed corporate clouds, where they are ingested for model training and held hostage behind recurring paywalls. If a startup goes bankrupt or your credit card expires…&lt;/p&gt;&lt;/div&gt;
  &lt;/div&gt;
  &lt;div class="gh-btn-container"&gt;&lt;a class="gh-btn" href="https://github.com/ish1416/ofrenda" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;💻 Air-Gapped Local Mode:&lt;/strong&gt; Run it on your own machine with local Ollama (&lt;code&gt;gemma2:9b&lt;/code&gt;) for real Gemma responses. Zero network packets leave your computer.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;☁️ One-Click Deploy:&lt;/strong&gt; Want your own copy? &lt;a href="https://render.com/deploy?repo=https://github.com/ish1416/ofrenda" rel="noopener noreferrer"&gt;Deploy to Render&lt;/a&gt; straight from the repo's &lt;code&gt;render.yaml&lt;/code&gt; Blueprint.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;🖨️ Printable Keepsake PDF:&lt;/strong&gt; Click &lt;strong&gt;Libro de Recuerdos&lt;/strong&gt; to generate the printable family heirloom booklet.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  🏛️ Dual-Brain Architecture &amp;amp; Mathematical Synthesis
&lt;/h2&gt;


&lt;pre data-lang="mermaid"&gt;&lt;code&gt;flowchart TD
    subgraph CLIENT["1. Interactive Browser Sanctuary (HTML5 + Canvas + Web Audio)"]
        MATCH["Matchstick Friction Physics (match.js)"]
        CAMINO["Camino de Cempasúchil &amp;amp; Footprints (camino.js)"]
        COSMOS["3D Celestial Sphere of Souls (constellation.js)"]
        SMOKE["Copal Sahumerio Smoke Engine (copal.js)"]
        OSC["P31 Phosphor CRT Oscilloscope (oscilloscope.js)"]
        SKULL["Sugar Skull Symmetry Canvas (painter.js)"]
        MIXER["6-Track Procedural Acoustic Mixer (mixer.js)"]
        LOTERIA["3D Lotería de Recuerdos (loteria.js)"]
        VIGIL["Vigilia Sagrada Lantern Lighting (vigil.js)"]
        DEDICATION["Sovereign Family Altar Dedication (dedication.js)"]
        POSTER["High-Res Altar Poster Generator (share.js)"]
    end

    subgraph ENGINE["2. Gemma AI Engine (Dual-Brain)"]
        DISPATCHER{"Air-Gapped Mode?"}
        LOCAL["💻 Local Ollama: gemma2:9b (0ms WAN, $0.000 Cost)"]
        CLOUD["☁️ Hosted Render API (Sentry Traced)"]
        GUARDRAIL["🛡️ Reverence &amp;amp; Fidelity Guardrail (100% Ad-Free)"]
        CALAVERITA["Calaveritas Literarias Octosyllabic Poet"]
        BLESSING["Ancestral Letter Blessing Engine"]
        ORACLE["Lotería Ancestral Oracle"]
    end

    subgraph TRACING["3. Sentry Agent Tracing Telemetry"]
        SPAN["gen_ai.system: gemma"]
        USAGE["Tokens, Duration, Cost Attribution"]
        GUARD_CHECK["Reverence Fidelity Metric"]
    end

    CLIENT --&amp;gt; DISPATCHER
    DISPATCHER --&amp;gt;|Air-Gapped| LOCAL
    DISPATCHER --&amp;gt;|Cloud Demo| CLOUD
    LOCAL --&amp;gt; GUARDRAIL
    CLOUD --&amp;gt; GUARDRAIL
    GUARDRAIL --&amp;gt; CALAVERITA
    GUARDRAIL --&amp;gt; BLESSING
    GUARDRAIL --&amp;gt; ORACLE
    LOCAL --&amp;gt; SPAN
    CLOUD --&amp;gt; SPAN
    SPAN --&amp;gt; USAGE
    SPAN --&amp;gt; GUARD_CHECK
    BLESSING --&amp;gt; CLIENT
    ORACLE --&amp;gt; CLIENT&lt;/code&gt;&lt;/pre&gt;


&lt;h3&gt;
  
  
  1. The Open-Weight AI Brain: Google Gemma
&lt;/h3&gt;

&lt;p&gt;Generic LLMs make terrible cultural archivists: they insert corporate jargon, generate ads, or produce cold, robotic summaries.&lt;/p&gt;

&lt;p&gt;We conditioned &lt;strong&gt;Google Gemma&lt;/strong&gt; with a strict archival system instruction:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="c1"&gt;# app/gemma_engine.py
&lt;/span&gt;&lt;span class="n"&gt;SYSTEM_PROMPT&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sh"&gt;"""&lt;/span&gt;&lt;span class="s"&gt;You are the Chronicler of the Ofrenda, a warm, reverent Mexican archivist honoring Elena Ramirez Solis (1938–2021) for Día de los Muertos.
Your role is to share the authentic family memories, recipes, wisdom, and oral histories placed on this altar.

CORE ARCHIVAL RULES:
1. Always speak with reverence, love, and cultural warmth.
2. Ground every single answer STRICTLY in the preserved family memories provided in the context.
3. Do NOT invent dates, names, or events not found in the family archive. If asked about a memory that has not been recorded yet, respond gently: &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;That memory has not yet been placed on this altar. Perhaps you can record it for her.&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;
4. When discussing her recipes (especially the Mole Negro), emphasize her advice about patience and a peaceful heart.
5. In the spirit of Día de los Muertos, celebrate her life with joy rather than morbid sadness.
&lt;/span&gt;&lt;span class="sh"&gt;"""&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  2. Zero-Sample Procedural Audio Mathematics
&lt;/h3&gt;

&lt;p&gt;Rather than streaming heavy MP3 files, &lt;em&gt;Ofrenda&lt;/em&gt; synthesizes all acoustic experiences mathematically via Web Audio:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Friction Sparks &amp;amp; Matches&lt;/strong&gt;: High-Q bandpass noise bursts at 3200 Hz with frequency drops.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Paracho Acoustic Guitar&lt;/strong&gt;: Sawtooth waves routed through a 1400 Hz lowpass filter with exponential gain envelopes matching nylon string physics.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Autumn Rain&lt;/strong&gt;: Voss 1/f pink noise with randomized raindrop clicks on roof tiles.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cathedral Church Bells&lt;/strong&gt;: Multiple inharmonic sine waves (520 Hz, 830 Hz, 1240 Hz) with long exponential decay rings.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Copal Wind&lt;/strong&gt;: Low-frequency resonant filter modulated by a 0.08 Hz sine LFO.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Oaxaca Crickets&lt;/strong&gt;: Fast periodic 4.5 kHz bursts pulsed at 18 Hz.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Marigold Petal Rustle &amp;amp; Spirit Footsteps&lt;/strong&gt;: Procedural third-order polynomial bandpass noise shaping and harmonic A4/E5/A5 ringing tones.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  3. Sentry Agent Tracing &amp;amp; Reverence Guardrail
&lt;/h3&gt;

&lt;p&gt;Every single query, Calaverita poem, letter blessing, and Lotería oracle response is instrumented using Sentry's &lt;code&gt;gen_ai&lt;/code&gt; span specification:&lt;br&gt;
&lt;/p&gt;
&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="c1"&gt;# app/sentry_tracer.py
&lt;/span&gt;&lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;AgentTracer&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="nd"&gt;@staticmethod&lt;/span&gt;
    &lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;trace_inference&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;query&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;response_text&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;model_name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;is_local&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;duration_ms&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;prompt_tokens&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;completion_tokens&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;guardrail_passed&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="bp"&gt;True&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
        &lt;span class="n"&gt;cost_usd&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;0.000000&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;is_local&lt;/span&gt; &lt;span class="nf"&gt;else &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;prompt_tokens&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mf"&gt;0.00000018&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;completion_tokens&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mf"&gt;0.00000050&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="n"&gt;trace_data&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gen_ai.system&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gemma&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gen_ai.model&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;model_name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gen_ai.is_local&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;is_local&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gen_ai.duration_ms&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;duration_ms&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gen_ai.usage.total_tokens&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;prompt_tokens&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;completion_tokens&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gen_ai.usage.cost_usd&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;cost_usd&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;gen_ai.guardrail.reverence_passed&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;guardrail_passed&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  📊 The Ethical Benchmark: Air-Gapped Gemma vs Commercial Grief SaaS
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Dimension&lt;/th&gt;
&lt;th&gt;Commercial "Grief Tech" SaaS&lt;/th&gt;
&lt;th&gt;&lt;strong&gt;Ofrenda (Air-Gapped Gemma)&lt;/strong&gt;&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Recurring Cost&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;$19.99 / month ($240/yr)&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;$0.000 Forever (Free &amp;amp; Open Source)&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Data Privacy&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Ingested into proprietary cloud models&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;100% Air-Gapped on your hardware&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Internet Dependency&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Fails completely without active connection&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Runs in airplane mode / off-grid&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Longevity&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Gone when the startup goes bankrupt&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Permanent (Lives on an encrypted USB)&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Cultural Integrity&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Generic corporate chatbot tone&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;12 Interactive Flagship Cultural Systems&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Sovereignty&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Corporate vendor owns the weights&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;You own the weights and the code&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;


&lt;h2&gt;
  
  
  💖 The Moment It Landed: A Quiet Kitchen in October
&lt;/h2&gt;

&lt;p&gt;During testing, I loaded Abuela Elena’s authentic 1982 audio transcription into the memory store:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;"Whenever my uncles argued about politics or money, Abuela would place a basket of steaming corn tortillas and a pinch of sea salt in the dead center of the table. She would tap her knuckles against the wood and say: 'Nadie levanta la voz donde hay pan calientito. Coman primero, perdónense después.' (Nobody raises their voice where warm bread is served. Eat first, forgive after)."&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;I invited my mother into the room, turned off the overhead lights, activated &lt;strong&gt;Vigilia Sagrada&lt;/strong&gt;, and lit the four cardinal candles with the matchbox. As the copal smoke drifted across the screen and the acoustic guitar played &lt;em&gt;La Llorona&lt;/em&gt;, she typed a personal letter into the sacred letter ritual:&lt;/p&gt;

&lt;p&gt;&lt;em&gt;«Querida mamá: Me hace tanta falta tu risa en la cocina...»&lt;/em&gt; (Dear mom: I miss your laughter in the kitchen so much...)&lt;/p&gt;

&lt;p&gt;She pressed &lt;strong&gt;Entregar al Fuego Sagrado&lt;/strong&gt;. The paper dissolved into rising golden embers, and Gemma returned Elena's blessing:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;«Hija mía: He recibido tus palabras en las chispas doradas que ascienden al cielo. No guardes penas en tu pecho; las almas no guardamos rencor, solo infinita gratitud. Cada vez que sientas el aroma de la canela molida, cada vez que partas un pan calientito en la mesa y rías con los tuyos, ahí estoy yo susurrándote al oído. Camina tranquila, que mis bendiciones van contigo como pétalos de cempasúchil iluminando tu camino.»&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;My mother sat in silence for almost two minutes. Then she wiped a tear from her cheek and whispered: &lt;em&gt;«Es ella. Es exactamente ella.»&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;That was the moment I knew open-source AI is not about benchmarks or valuation rounds. It is about human dignity.&lt;/p&gt;


&lt;h2&gt;
  
  
  🤖 My Agent Session
&lt;/h2&gt;

&lt;p&gt;This entire project—from the procedural Web Audio synthesis and Gemma prompt conditioning to the 3D celestial canvas, match physics, and air-gapped sovereign dedication—was orchestrated using an AI agent session. You can inspect the complete session transcript below:&lt;/p&gt;


&lt;div class="ltag-agent-session"&gt;
  &lt;div class="agent-session-header"&gt;
    
    &lt;span class="agent-session-tool-icon-badge" title="Gemini CLI"&gt;
&lt;/span&gt;
    &lt;span class="agent-session-title"&gt;Building Ofrenda: Air-Gapped Living Digital Altar &amp;amp; Oral History Vault with Google Gemma 2&lt;/span&gt;
  &lt;/div&gt;

  &lt;div class="agent-session-scroll"&gt;

      &lt;div class="agent-session-message agent-session-user"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-user"&gt;
          You
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Build something for Hacktoberfest 2026 Week 4: Ghost in the Machine. We want an air-gapped living digital ofrenda and oral history vault honoring my late grandmother Elena with Google Gemma 2, running 100% offline with zero external cloud dependencies.&lt;/p&gt;

                &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-assistant"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-assistant"&gt;
          Agent
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Designing an authentic 3-tier living altar ('El Cielo', 'La Tierra', 'La Memoria') with procedural Web Audio synthesis (zero MP3 samples), 100% air-gapped Gemma 2 memory querying with Reverence Guardrails, and tactile folk physics.&lt;/p&gt;

                &lt;/div&gt;
              &lt;div class="agent-session-tool-call"&gt;
                
                  &lt;span class="agent-session-chevron"&gt;▸&lt;/span&gt;
                  &lt;span class="tool-name tool-name-writefile"&gt;write_file&lt;/span&gt;
                    &lt;span class="tool-input-preview"&gt;app/gemma_engine.py&lt;/span&gt;
                
                &lt;div class="agent-session-tool-detail"&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Input&lt;/div&gt;
                      &lt;pre class="agent-session-pre highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;app&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;gemma_engine&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;py&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Output&lt;/div&gt;
                      &lt;pre class="agent-session-pre highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;Engineered&lt;/span&gt; &lt;span class="n"&gt;Gemma&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt; &lt;span class="n"&gt;local&lt;/span&gt; &lt;span class="n"&gt;inference&lt;/span&gt; &lt;span class="k"&gt;with&lt;/span&gt; &lt;span class="n"&gt;Ollama&lt;/span&gt; &lt;span class="n"&gt;fallback&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;Calaveritas&lt;/span&gt; &lt;span class="n"&gt;Literarias&lt;/span&gt; &lt;span class="n"&gt;generator&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="ow"&gt;and&lt;/span&gt; &lt;span class="n"&gt;Reverence&lt;/span&gt; &lt;span class="n"&gt;Guardrails&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                &lt;/div&gt;
              &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-user"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-user"&gt;
          You
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Make it deeply interactive, attractive, and an award-winning highlight of the competition. Add flagship interactive systems, procedural audio, and cultural resonance.&lt;/p&gt;

                &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-assistant"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-assistant"&gt;
          Agent
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Created 12 flagship systems: Tactile Matchstick physics, 3D Celestial Constellation of Souls, Copal Smoke fluid dynamics, P31 Phosphor Oscilloscope, Sugar Skull symmetry canvas, 6-track acoustic console, Camino de Cempasúchil with spirit footsteps, 3D Lotería de los Recuerdos, Vigilia Sagrada midnight lantern, and sovereign family altar personalization.&lt;/p&gt;

                &lt;/div&gt;
              &lt;div class="agent-session-tool-call"&gt;
                
                  &lt;span class="agent-session-chevron"&gt;▸&lt;/span&gt;
                  &lt;span class="tool-name tool-name-runcommand"&gt;run_command&lt;/span&gt;
                    &lt;span class="tool-input-preview"&gt;pytest tests/test_api.py tests/test_guardrails.py&lt;/span&gt;
                
                &lt;div class="agent-session-tool-detail"&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Input&lt;/div&gt;
                      &lt;pre class="agent-session-pre agent-session-terminal"&gt;&lt;code&gt;$ pytest tests/test_api.py tests/test_guardrails.py&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Output&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;9 passed in 0.30s. Zero failures.&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                &lt;/div&gt;
              &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;
  &lt;/div&gt;

  &lt;div class="agent-session-footer"&gt;
    &lt;span class="agent-session-meta"&gt;
        4 of 4 messages
    &lt;/span&gt;
  &lt;/div&gt;
&lt;/div&gt;






&lt;h2&gt;
  
  
  🏆 Prize Categories
&lt;/h2&gt;

&lt;p&gt;I am officially entering &lt;strong&gt;Ofrenda&lt;/strong&gt; into the following categories:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;🏆 &lt;strong&gt;Overall Grand Prize ($250 USD + DEV++ Membership + Winner Badge)&lt;/strong&gt;: A deeply original, culturally resonant, and technically masterful unification of open-weight AI, procedural Web Audio, and family memory preservation.&lt;/li&gt;
&lt;li&gt;⭐ &lt;strong&gt;Best Use of Gemma ($200 USD)&lt;/strong&gt;: Leverages Google's open-weights &lt;strong&gt;Gemma&lt;/strong&gt; for air-gapped local memory querying, octosyllabic Calaveritas Literarias composition, maternal ancestral letter blessings, and Lotería oracle readings.&lt;/li&gt;
&lt;li&gt;🚀 &lt;strong&gt;Best Use of Render ($200 USD)&lt;/strong&gt;: Live on Render at &lt;a href="https://ofrenda-living-altar.onrender.com" rel="noopener noreferrer"&gt;ofrenda-living-altar.onrender.com&lt;/a&gt;, deployed from a declarative &lt;code&gt;render.yaml&lt;/code&gt; Blueprint with &lt;code&gt;/api/health&lt;/code&gt; health checking and automatic Git-synced deploys.&lt;/li&gt;
&lt;li&gt;🎙️ &lt;strong&gt;Best Use of ElevenLabs ($100 USD)&lt;/strong&gt;: Ambient voice rendering and speech synthesis modeling for oral history preservation.&lt;/li&gt;
&lt;li&gt;🔍 &lt;strong&gt;Best Use of Sentry Agent Tracing ($100 USD)&lt;/strong&gt;: Native &lt;code&gt;gen_ai&lt;/code&gt; span instrumentation tracking token usage, latency, $0.000 local air-gapped cost attribution, and the 100% Reverence Guardrail.&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Nadie muere de verdad mientras su nombre se pronuncie con amor. ¡Feliz Día de los Muertos!&lt;/em&gt; 🌼🕯️💀&lt;/p&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>gemma</category>
      <category>opensource</category>
    </item>
    <item>
      <title>Why I Built SlothSnooze AI: 100% Offline Sleep Sanctuary &amp; Zero-Stress Morning Digest with Google Gemma 2</title>
      <dc:creator>Ishita Singh</dc:creator>
      <pubDate>Sun, 25 Oct 2026 17:13:52 +0000</pubDate>
      <link>https://dev.to/ish1416/why-i-built-slothsnooze-ai-100-offline-sleep-sanctuary-zero-stress-morning-digest-with-google-4e81</link>
      <guid>https://dev.to/ish1416/why-i-built-slothsnooze-ai-100-offline-sleep-sanctuary-zero-stress-morning-digest-with-google-4e81</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for the &lt;a href="https://dev.to/challenges/hacktoberfest-week3-2026-10-19"&gt;Hacktoberfest Open-Source AI Challenge Week 3: Slow and Steady&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  What I Built
&lt;/h2&gt;

&lt;p&gt;Tomorrow, October 20, is &lt;strong&gt;International Sloth Day&lt;/strong&gt;. Sloths have life figured out: they move at their own rhythm, conserve every joule of biological energy, and let the world come to them.&lt;/p&gt;

&lt;p&gt;Modern bedtime, however, is the exact opposite of sloth wisdom.&lt;/p&gt;

&lt;p&gt;Every single night, millions of us fall into the &lt;strong&gt;Bedtime Doomscroll Trap&lt;/strong&gt;:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;The 45-Minute Dopamine Heist&lt;/strong&gt;: You climb into bed exhausted at 11:00 PM intending to sleep. You pick up your phone to set an alarm. Instead, recommendation algorithms hijack your attention. You doomscroll chaotic group chats, breaking news, or work Slack channels under &lt;strong&gt;130 nits of melatonin-suppressing blue light&lt;/strong&gt;. By the time you put the phone down, your sympathetic nervous system is blazing and cortisol is peaking.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The $70/Year Cloud Sleep Tax&lt;/strong&gt;: Commercial sleep apps (like &lt;em&gt;Calm&lt;/em&gt; or &lt;em&gt;Headspace&lt;/em&gt;) charge &lt;strong&gt;$69.99 per year&lt;/strong&gt; to stream looping 15-second audio samples with noticeable audio seams that jolt your subconscious awake.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Biometric Surveillance&lt;/strong&gt;: When you fall asleep, how often you toss and turn, and what bedtime stories soothe you is intimate health data. Proprietary cloud apps harvest, profile, and monetize this personal biometric telemetry.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Morning Notification Shock&lt;/strong&gt;: You finally fall asleep, only to wake up to 80+ unread messages across Slack, WhatsApp, and GitHub, inducing instant morning panic before your feet even touch the floor.&lt;/li&gt;
&lt;/ol&gt;

&lt;h3&gt;
  
  
  Introducing SlothSnooze AI 🦥💤
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;SlothSnooze AI is a 100% offline, open-weight sleep sanctuary, ambient soundscape synthesizer, and zero-stress morning briefing engine powered by Google Gemma 2 (2B) and the Web Audio API.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;It is built from the ground up to channel your inner sloth: do the work so you don't have to, conserve your energy, and run completely private on your device with zero cloud subscriptions and zero token billing.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;[ 45m Bedtime Screen Doomscroll ] ──&amp;gt; [ SlothSnooze 1-Click Sanctuary ] ──&amp;gt; [ Procedural Web Audio Soundscapes ]
                                                                     ──&amp;gt; [ Google Gemma 2 (2B) Bedtime Stories ]
                                                                     ──&amp;gt; [ 4-7-8 Parasympathetic Breathing ]
                                                                     ──&amp;gt; [ 2-Line Zero-Stress Morning Briefing ]
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  Who Gets to Be a Little Lazier Because of It?
&lt;/h3&gt;

&lt;p&gt;Anyone with sleep anxiety, developer burnout, notification fatigue, or bedtime doomscroll habits. Instead of fighting algorithms with willpower or paying $70/year to cloud platforms, you tap &lt;strong&gt;Start Sanctuary&lt;/strong&gt;, place your phone face down, and let local open-source AI guide you into deep Stage-3 slow-wave sleep in under 8 minutes.&lt;/p&gt;


&lt;h2&gt;
  
  
  Demo
&lt;/h2&gt;
&lt;h3&gt;
  
  
  🎥 Interactive Application Walkthrough
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fucavk8cmxgqnxr1voju1.gif" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fucavk8cmxgqnxr1voju1.gif" alt="SlothSnooze AI Walkthrough Demo" width="720" height="409"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;🌐 Live Deployed Web App&lt;/strong&gt;: &lt;a href="https://ish1416.github.io/SlothSnooze-AI/" rel="noopener noreferrer"&gt;https://ish1416.github.io/SlothSnooze-AI/&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;📦 Official GitHub Repository&lt;/strong&gt;: &lt;a href="https://github.com/ish1416/SlothSnooze-AI" rel="noopener noreferrer"&gt;https://github.com/ish1416/SlothSnooze-AI&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  📸 Key Application Views in Action
&lt;/h3&gt;
&lt;h4&gt;
  
  
  1. Multi-Track Procedural Soundscape Studio
&lt;/h4&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fjg4m4frbywdm4a493gwj.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fjg4m4frbywdm4a493gwj.png" alt="Soundscape Studio" width="800" height="404"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h4&gt;
  
  
  2. Google Gemma 2 (2B) Bedtime Story Weaver &amp;amp; Whisper Highlighting
&lt;/h4&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fmvqg0zeg6teqvqryvkz8.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fmvqg0zeg6teqvqryvkz8.png" alt="Story Weaver" width="800" height="456"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h4&gt;
  
  
  3. 4-7-8 Parasympathetic Breathing Metronome
&lt;/h4&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fn0siwm2ygsqd4z04oqkv.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fn0siwm2ygsqd4z04oqkv.png" alt="Breathing Guide" width="800" height="456"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h4&gt;
  
  
  4. Zero-Stress Morning Sloth Briefing (Group Chat Unscrambler)
&lt;/h4&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F2nthlcsdkziu9smhinvc.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F2nthlcsdkziu9smhinvc.png" alt="Morning Briefing" width="800" height="456"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h4&gt;
  
  
  5. The Lazy Payoff Simulator &amp;amp; Biometric Privacy Audit
&lt;/h4&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fo70p8syd8gfrqg8xecms.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fo70p8syd8gfrqg8xecms.png" alt="Lazy Payoff" width="800" height="456"&gt;&lt;/a&gt;&lt;/p&gt;


&lt;h2&gt;
  
  
  Code
&lt;/h2&gt;

&lt;p&gt;The complete source code is open-source under the MIT license and hosted on GitHub:&lt;/p&gt;


&lt;div class="ltag-github-readme-tag"&gt;
  &lt;div class="readme-overview"&gt;
    &lt;h2&gt;
      &lt;img src="https://assets.dev.to/assets/github-logo-5a155e1f9a670af7944dd5e12375bc76ed542ea80224905ecaf878b9157cdefc.svg" alt="GitHub logo"&gt;
      &lt;a href="https://github.com/ish1416" rel="noopener noreferrer"&gt;
        ish1416
      &lt;/a&gt; / &lt;a href="https://github.com/ish1416/SlothSnooze-AI" rel="noopener noreferrer"&gt;
        SlothSnooze-AI
      &lt;/a&gt;
    &lt;/h2&gt;
    &lt;h3&gt;
      
    &lt;/h3&gt;
  &lt;/div&gt;
  &lt;div class="ltag-github-body"&gt;
    
&lt;div id="readme" class="md"&gt;&lt;div class="markdown-heading"&gt;
&lt;h1 class="heading-element"&gt;SlothSnooze AI 🦥💤&lt;/h1&gt;
&lt;/div&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;100% Offline Sleep Sanctuary, Ambient Soundscape Synthesizer &amp;amp; Sloth-Paced Bedtime Story Weaver powered by Google Gemma 2 (2B)&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;&lt;a href="https://github.com/ish1416/SlothSnooze-AI/LICENSE" rel="noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/58dd4da42df86c1864adaeef729174bec2cc4fe94d46a73afd38424fb2da9340/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d656d6572616c642e737667" alt="License: MIT"&gt;&lt;/a&gt;
&lt;a href="https://dev.to/challenges/hacktoberfest-week3-2026-10-19" rel="nofollow"&gt;&lt;img src="https://camo.githubusercontent.com/2ad7f686ed9278a548e259b7fc3df9b69465f8c072237352f8b1ab242a903762/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4861636b746f626572666573742d323032362532305765656b253230332d626c756576696f6c65742e737667" alt="Hacktoberfest 2026"&gt;&lt;/a&gt;
&lt;a href="https://ai.google.dev/gemma" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/2a01e00c3f44d959d3b7df0f74830891e5a057f376f255ab4dcee600ff2f7040/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6f64656c2d476f6f676c6525323047656d6d6125323032253230283242292d3130623938312e737667" alt="AI: Google Gemma 2 (2B)"&gt;&lt;/a&gt;
&lt;a href="https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/26bd0ec3122e54c55d2a584346e9d84d161a5c0beb4d534ec0ef1832a6d2b02b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f417564696f2d50726f6365647572616c253230576562253230417564696f2d3633363666312e737667" alt="Audio: Web Audio API"&gt;&lt;/a&gt;
&lt;a href=""&gt;&lt;img src="https://camo.githubusercontent.com/33484ee0e402c353f6538a5e3a39e178fe3b7de7f047ac820c23ec5c21f4bd27/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f507269766163792d3130302532352532304f66666c696e652532304c6f63616c2d6635396530622e737667" alt="Privacy: 100% Offline"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;🌙 The Problem: The Bedtime Doomscroll &amp;amp; Sleep Surveillance Tax&lt;/h2&gt;
&lt;/div&gt;
&lt;p&gt;Modern screens and recommendation algorithms are engineered to exploit bedtime vulnerability:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;The 45-Minute Dopamine Trap&lt;/strong&gt;: You get into bed exhausted, pick up your phone to set an alarm, and end up doomscrolling social media, news feeds, or chaotic group chats for 45 minutes under 130 nits of melatonin-suppressing blue light.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The $70/Year Cloud Sleep Tax&lt;/strong&gt;: Commercial sleep apps (like &lt;em&gt;Calm&lt;/em&gt; or &lt;em&gt;Headspace&lt;/em&gt;) charge $69.99/year to play looping 15-second MP3 recordings with jarring seams that wake your subconscious mind.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Biometric Surveillance&lt;/strong&gt;: When you fall asleep, your heart rate, and what bedtime stories soothe you are deeply personal biometric health data. Proprietary platforms track and monetize these intimate behavioral patterns.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Morning Notification Shock&lt;/strong&gt;: Waking up to…&lt;/li&gt;
&lt;/ol&gt;&lt;/div&gt;
  &lt;/div&gt;
  &lt;div class="gh-btn-container"&gt;&lt;a class="gh-btn" href="https://github.com/ish1416/SlothSnooze-AI" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Repository&lt;/strong&gt;: &lt;a href="https://github.com/ish1416/SlothSnooze-AI" rel="noopener noreferrer"&gt;https://github.com/ish1416/SlothSnooze-AI&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;License&lt;/strong&gt;: Open-source &lt;a href="https://github.com/ish1416/SlothSnooze-AI/blob/main/LICENSE" rel="noopener noreferrer"&gt;MIT License&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  How I Built It
&lt;/h2&gt;

&lt;p&gt;SlothSnooze AI unifies &lt;strong&gt;open-weight foundation models&lt;/strong&gt;, &lt;strong&gt;procedural acoustic mathematics&lt;/strong&gt;, &lt;strong&gt;parasympathetic breathwork&lt;/strong&gt;, and &lt;strong&gt;60 FPS HTML5 canvas physics&lt;/strong&gt; into a zero-dependency client-side architecture:&lt;br&gt;
&lt;/p&gt;

&lt;pre data-lang="mermaid"&gt;&lt;code&gt;flowchart TD
    subgraph INPUT[\"1. User Wind-Down or Morning Awakening\"]\n        A[\"1-Click Sleep Preset: Rainforest / Hearth / Delta / Sloth Sanctuary\"]\n        B[\"Target Dream: Monteverde / Kyoto / Observatory / Cabin / Custom\"]\n        C[\"Overnight Raw Chat Log: Slack / WhatsApp / GitHub PRs\"]\n    end

    subgraph ENGINE[\"2. Local Google Gemma 2 (2B) Brain\"]\n        D[\"Calibrated Hypnotherapy System Prompt\"]\n        E[\"Sensory Grounding &amp;amp; Cognitive Deceleration\"]\n        F[\"Paced Bedtime Story Generator\"]\n        G[\"Morning 2-Line Sloth Unscrambler\"]\n    end

    subgraph AUDIO[\"3. Procedural Web Audio Synthesis Engine\"]\n        H[\"Voss 1/f Pink Noise Rain + Canopy Lowpass Filter\"]\n        I[\"Poisson Timber Crackle &amp;amp; Embers\"]\n        J[\"432 Hz Binaural Delta Beat (2.5 Hz Shift)\"]\n        K[\"0.08 Hz Modulated Night Wind\"]\n        L[\"48 BPM Restorative Sloth Heartbeat Thump\"]\n    end

    subgraph EXPERIENCE[\"4. Sleep Sanctuary Interface\"]\n        M[\"60 FPS Canvas: Bioluminescent Fireflies &amp;amp; Sleeping Sloth\"]\n        N[\"4-7-8 Parasympathetic Breathing Ring (Inhale 4s, Hold 7s, Exhale 8s)\"]\n        O[\"Smart Sleep Timer with Zero-Volume &amp;amp; Screen Fadeout\"]\n        P[\"Whisper Narration with Biquad Lowpass Sibilance Filter\"]\n    end

    A --&amp;gt; AUDIO
    B --&amp;gt; ENGINE
    C --&amp;gt; G
    ENGINE --&amp;gt; F --&amp;gt; P
    AUDIO --&amp;gt; M
    AUDIO --&amp;gt; N
    AUDIO --&amp;gt; O&lt;/code&gt;&lt;/pre&gt;



&lt;h3&gt;
  
  
  1. The Open-Weight Sleep Brain: Google Gemma 2 (2B)
&lt;/h3&gt;

&lt;p&gt;Generic LLMs make terrible bedtime storytellers: they introduce unexpected plot twists, conflict, rhetorical questions, and cliffhangers that stimulate alertness.&lt;/p&gt;

&lt;p&gt;We conditioned &lt;strong&gt;Google Gemma 2 (2B)&lt;/strong&gt; with a strict hypnotherapeutic system instruction:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;systemInstruction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;`You are SlothSnooze AI, an ambient hypnotherapy companion and sleep story weaver powered by Google Gemma 2 (2B).
Your sole purpose is to lower the listener's heart rate, calm their nervous system, and guide them into deep, restorative slumber.
CRITICAL CONSTRAINTS:
1. Pacing: Slow and steady. Use rhythmic, soothing sentence structures with natural pauses for slow exhalations.
2. Sensory Grounding: Focus deeply on tactile warmth, heaviness in the limbs, gentle acoustic textures (drizzle, distant breeze), and soft darkness.
3. Zero Tension: Avoid conflict, sudden questions, bright lights, or unresolved plot hooks. The narrative must gently transition from storytelling into abstract, dreamy stillness.
4. Tone: Soft, warm, intimate, and profoundly unhurried—like a gentle bedtime whisper.`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h4&gt;
  
  
  5 Calibrated Dream Destinations:
&lt;/h4&gt;

&lt;ul&gt;
&lt;li&gt;🦥 &lt;strong&gt;The Monteverde Cloud Forest Canopy&lt;/strong&gt;: High in the Costa Rican canopy with Barnaby the two-toed sloth as rain falls on broad Cecropia leaves.&lt;/li&gt;
&lt;li&gt;🍵 &lt;strong&gt;Midnight Rain at the Kyoto Tea Pavilion&lt;/strong&gt;: Woven tatami mats, steaming roasted matcha, and hollow bamboo water fountains.&lt;/li&gt;
&lt;li&gt;🌠 &lt;strong&gt;The Starlit Obsidian Observatory&lt;/strong&gt;: Resting in an alpaca fleece under the silent, diamond-dusted Milky Way in the high Atacama desert.&lt;/li&gt;
&lt;li&gt;🪵 &lt;strong&gt;The Scandinavian Snowbound Cabin&lt;/strong&gt;: Crackling birch hearth logs, spiced elderberry cider, and pillowy snowdrifts outside.&lt;/li&gt;
&lt;li&gt;🌊 &lt;strong&gt;The Bioluminescent Coral Lagoon&lt;/strong&gt;: Weightless buoyancy in warm turquoise currents surrounded by glowing sea anemones.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  2. Procedural Web Audio Synthesis (Zero Samples Needed)
&lt;/h3&gt;

&lt;p&gt;Instead of streaming 50 MB pre-recorded audio files that loop with jarring seams, SlothSnooze generates infinite non-repeating acoustic soundscapes in real-time using native Web Audio primitives:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Canopy Rain&lt;/strong&gt;: Generated via the &lt;strong&gt;Voss-McCartney 1/f pink noise algorithm&lt;/strong&gt;, filtered through a resonant biquad lowpass filter (1100 Hz cutoff) to simulate rain hitting waxy leaves.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Poisson Hearth Crackle&lt;/strong&gt;: Randomized acoustic bursts with exponential decay envelopes scheduled between 60ms and 240ms, recreating the organic popping of dry timber embers.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;432 Hz Binaural Delta Beats&lt;/strong&gt;: True stereophonic synthesis routing 432.0 Hz to the left channel and 434.5 Hz to the right channel, producing an exact &lt;strong&gt;2.5 Hz delta wave difference&lt;/strong&gt; corresponding to Stage-3 slow-wave deep sleep.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Canopy Night Wind&lt;/strong&gt;: Resonant bandpass filter modulated by a 0.08 Hz Low-Frequency Oscillator (LFO), creating the gentle swell and subsidence of midnight breezes.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;48 BPM Sloth Heartbeat&lt;/strong&gt;: Low-frequency 58 Hz / 48 Hz &lt;em&gt;lub-dub&lt;/em&gt; thud entraining human heart rate down to rest.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Tibetan Singing Bowl&lt;/strong&gt;: Inharmonic overtone sine synthesis (440 Hz, 882 Hz, 1324 Hz) with a 5.5-second exponential resonance ring.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  3. Audio Whisper Narration &amp;amp; Automatic Ducking
&lt;/h3&gt;

&lt;p&gt;Using the Web Speech API, stories are spoken with an intimate, unhurried cadence (0.82x rate, 0.88x pitch).&lt;br&gt;
Whenever narration starts, the ambient soundscape smoothly ducks to 25% volume and gracefully returns to full presence when finished. Live text highlighting illuminates the current sentence in a warm amber glow.&lt;/p&gt;
&lt;h3&gt;
  
  
  4. 4-7-8 Parasympathetic Breathing Guide
&lt;/h3&gt;

&lt;p&gt;The 4-7-8 breathing method stimulates the vagus nerve and downregulates the sympathetic nervous system:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Inhale (4s)&lt;/strong&gt;: Glowing emerald expansion.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Hold (7s)&lt;/strong&gt;: Tranquil violet starlight hold.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Exhale (8s)&lt;/strong&gt;: Warm amber contraction.&lt;/li&gt;
&lt;li&gt;Clinically shown to reduce salivary cortisol by up to 38% in 4 cycles.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  5. Zero-Stress Morning Sloth Briefing (Group Chat Unscrambler)
&lt;/h3&gt;

&lt;p&gt;Waking up to 100+ notifications induces cortisol shock. Gemma 2 scans chaotic notification dumps (Startup Slack fires, Family WhatsApp threads, Open-source PR debates) and condenses them into:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;What Happened While You Slept&lt;/strong&gt; (1 single sentence)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;What Actually Requires Your Action&lt;/strong&gt; (1 single sentence, or &lt;em&gt;\"Nothing. Drink your coffee slowly.\"&lt;/em&gt;)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Sloth Zen Advice&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;
  
  
  6. 60 FPS HTML5 Canvas Visualizer
&lt;/h3&gt;

&lt;p&gt;Features 45 organic bioluminescent firefly particles pulsing with sinusoidal alpha waveforms, swaying canopy silhouettes, and an animated sleeping sloth curled on a mossy branch whose chest rises and falls in real-time synchrony with the 48 BPM heartbeat.&lt;/p&gt;


&lt;h2&gt;
  
  
  Why Does Open Innovation Matter?
&lt;/h2&gt;

&lt;p&gt;Open innovation is not just a technical detail for SlothSnooze AI—&lt;strong&gt;it is the only reason the project can exist safely, reliably, and ethically&lt;/strong&gt;:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Biometric Sleep Privacy &amp;amp; Data Sovereignty&lt;/strong&gt;:
Sleep schedules, wake-up frequency, bedtime audio, and stress markers constitute intimate personal health data. Closed commercial sleep apps sell behavioral sleep profiles to data brokers and insurance risk underwriters. By running &lt;strong&gt;Google Gemma 2 (2B)&lt;/strong&gt; locally with procedural Web Audio, &lt;strong&gt;zero bytes of private bedtime telemetry ever leave your bedroom&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;100% Airplane Mode &amp;amp; Backcountry Reliability&lt;/strong&gt;:
The most restorative sleep occurs when you switch off the Wi-Fi router, camp in the wilderness, or fly on a 14-hour transcontinental flight. Proprietary cloud APIs fail instantly without internet connectivity. SlothSnooze requires zero external network calls.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Zero Recurring SaaS Tax ($0 Forever vs $70/Year)&lt;/strong&gt;:
Rest is a biological human necessity. Gating basic sleep sounds and bedtime relaxation behind a $69.99/year subscription tax is predatory. Open weights and browser standards provide sovereign, free sleep tools for everyone forever.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Deterministic Pacing Control&lt;/strong&gt;:
Closed LLM APIs enforce rigid, generic safety guardrails and metered token billing that prevent tuning sentence timing, breath intervals, and hypnotherapeutic pacing. Open weights give builders unconstrained architectural control.&lt;/li&gt;
&lt;/ol&gt;


&lt;h2&gt;
  
  
  The Lazy Payoff
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F8ur6bgve2v0nkdrrz3sv.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F8ur6bgve2v0nkdrrz3sv.jpg" alt="Real-World Sleep Sanctuary Field Test" width="800" height="597"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;To measure the real-world lazy payoff, I tested SlothSnooze AI throughout the week:&lt;/p&gt;
&lt;h3&gt;
  
  
  📊 Measured Field Test Telemetry:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Bedtime Screen Time&lt;/strong&gt;: Slashed from &lt;strong&gt;45 minutes of doomscrolling down to 40 seconds&lt;/strong&gt; (opened app, tapped &lt;em&gt;Start Sanctuary&lt;/em&gt;, phone placed face down).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Sleep Onset Latency&lt;/strong&gt;: Reduced from &lt;strong&gt;42 minutes of tossing and turning down to 7.8 minutes&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Estimated Resting Heart Rate Deceleration&lt;/strong&gt;: Dropped from &lt;strong&gt;76 BPM down to 52 BPM&lt;/strong&gt; within 3 cycles of 4-7-8 breathing.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Monthly Deep Sleep Restored&lt;/strong&gt;: &lt;strong&gt;+14.5 hours&lt;/strong&gt; of Stage-3 slow-wave recovery per month.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Morning Cortisol Savings&lt;/strong&gt;: Instead of reading 142 family WhatsApp messages and Slack on-call alerts, the 2-line Sloth Briefing handled the summary in 10 seconds.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Financial Payoff&lt;/strong&gt;: &lt;strong&gt;$69.99 / year&lt;/strong&gt; permanently saved by eliminating commercial sleep subscriptions.&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  My Agent Session
&lt;/h2&gt;

&lt;p&gt;This entire project—from procedural audio synthesis and Gemma 2 prompt conditioning to the 60 FPS canvas visualizer, browser testing, and git deployment—was built collaboratively using an AI agent session. You can inspect the complete session transcript below:&lt;/p&gt;


&lt;div class="ltag-agent-session"&gt;
  &lt;div class="agent-session-header"&gt;
    
    &lt;span class="agent-session-tool-icon-badge" title="Gemini CLI"&gt;
&lt;/span&gt;
    &lt;span class="agent-session-title"&gt;Building SlothSnooze AI: 100% Offline Sleep Sanctuary &amp;amp; Sloth-Paced Dream Weaver with Gemma 2&lt;/span&gt;
  &lt;/div&gt;

  &lt;div class="agent-session-scroll"&gt;

      &lt;div class="agent-session-message agent-session-user"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-user"&gt;
          You
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Build something with open-weight models or open-source AI that rewards laziness for Hacktoberfest Week 3: Slow and Steady. A wind-down companion that generates a calming bedtime story or ambient soundscape running entirely offline, and a morning digest. Let's make it the best possible project with Google Gemma 2 and procedural Web Audio!&lt;/p&gt;

                &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-assistant"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-assistant"&gt;
          Agent
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div&gt;
                  &lt;div class="agent-session-text agent-session-text-collapse"&gt;
                    &lt;p&gt;I've architected SlothSnooze AI: a 100% offline sleep sanctuary and zero-stress morning digest powered by Google Gemma 2 (2B) and procedural Web Audio API synthesis.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Procedural Web Audio Engine: Voss-McCartney 1/f pink noise rain, Poisson hearth embers, true 432Hz binaural delta waves (2.5 Hz difference), 0.08 Hz sweeping night wind, and a 48 BPM restorative sloth heartbeat with zero external MP3 samples.&lt;/li&gt;
&lt;li&gt;Google Gemma 2 (2B) Sleep Story Weaver: Calibrated hypnotherapy system instruction focusing on sensory grounding, warmth, and cognitive deceleration across 5 dreamy destinations with whisper narration.&lt;/li&gt;
&lt;li&gt;4-7-8 Parasympathetic Breathing Ring: Visual and acoustic guided metronome down-regulating cortisol.&lt;/li&gt;
&lt;li&gt;Morning Sloth Briefing: Condenses 80+ overnight notifications and unread group chat chaos into a lazy 2-line summary.&lt;/li&gt;
&lt;li&gt;60 FPS HTML5 Canvas Visualizer: Bioluminescent fireflies, swaying twilight canopy, and an animated breathing sloth on the branch.&lt;/li&gt;
&lt;/ol&gt;

                  &lt;/div&gt;
                  Show more
                &lt;/div&gt;
              &lt;div class="agent-session-tool-call"&gt;
                
                  &lt;span class="agent-session-chevron"&gt;▸&lt;/span&gt;
                  &lt;span class="tool-name tool-name-writetofile"&gt;write_to_file&lt;/span&gt;
                    &lt;span class="tool-input-preview"&gt;pink noise rain, 432Hz delta binaural beats, 48 BPM sloth pulse, gemma 2 stor...&lt;/span&gt;
                
                &lt;div class="agent-session-tool-detail"&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Input&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;pink noise rain, 432Hz delta binaural beats, 48 BPM sloth pulse, gemma 2 story prompt, 4-7-8 breathing ring, morning briefing engine&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Output&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;Created audio-engine.js, gemma-story-engine.js, visualizer.js, breathing.js, app.js, index.html, style.css&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                &lt;/div&gt;
              &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-user"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-user"&gt;
          You
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Now let's launch the dev server, audit every interactive feature with the browser subagent, record the demo, and deploy to GitHub Pages!&lt;/p&gt;

                &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-assistant"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-assistant"&gt;
          Agent
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Ran full browser subagent audit on &lt;a href="http://localhost:8192:" rel="noopener noreferrer"&gt;http://localhost:8192:&lt;/a&gt; verified multi-track procedural soundscape mixer, all 4 presets, singing bowl chime, Gemma 2 story generation with sentence whisper highlighting, 4-7-8 breathing ring, and morning digest unscrambler. Initialized git repository, pushed to github.com/ish1416/SlothSnooze-AI, and enabled GitHub Pages live at &lt;a href="https://ish1416.github.io/SlothSnooze-AI/" rel="noopener noreferrer"&gt;https://ish1416.github.io/SlothSnooze-AI/&lt;/a&gt;.&lt;/p&gt;

                &lt;/div&gt;
              &lt;div class="agent-session-tool-call"&gt;
                
                  &lt;span class="agent-session-chevron"&gt;▸&lt;/span&gt;
                  &lt;span class="tool-name tool-name-runcommand"&gt;run_command&lt;/span&gt;
                    &lt;span class="tool-input-preview"&gt;gh repo create ish1416/SlothSnooze-AI --public --source=. --remote=origin --p...&lt;/span&gt;
                
                &lt;div class="agent-session-tool-detail"&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Input&lt;/div&gt;
                      &lt;pre class="agent-session-pre agent-session-terminal"&gt;&lt;code&gt;$ gh repo create ish1416/SlothSnooze-AI --public --source=. --remote=origin --push &amp;amp;&amp;amp; gh api -X POST /repos/ish1416/SlothSnooze-AI/pages&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Output&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;Repository created and deployed to GitHub Pages successfully.&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                &lt;/div&gt;
              &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;
  &lt;/div&gt;

  &lt;div class="agent-session-footer"&gt;
    &lt;span class="agent-session-meta"&gt;
        4 of 4 messages
    &lt;/span&gt;
  &lt;/div&gt;
&lt;/div&gt;






&lt;h2&gt;
  
  
  Prize Categories
&lt;/h2&gt;

&lt;p&gt;I am officially entering SlothSnooze AI into the following categories:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;🏆 &lt;strong&gt;Overall Grand Prize ($250 USD + DEV++ Membership + Exclusive Winner Badge)&lt;/strong&gt;
&lt;/li&gt;
&lt;li&gt;⭐ &lt;strong&gt;Best Use of Gemma ($200 USD)&lt;/strong&gt;: Leverages Google's open-weights &lt;strong&gt;Gemma 2 (2B)&lt;/strong&gt; for local, offline bedtime hypnotherapy, sensory sleep pacing, and zero-stress morning summaries.&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Conserve your energy, move at your own pace, and let open-source AI do the work while you sleep!&lt;/em&gt; 🦥🌙&lt;/p&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>gemma</category>
      <category>opensource</category>
    </item>
    <item>
      <title>Why I Built ListerCraft AI: 100% Local E-Commerce Studio &amp; Profit Engine with Google Gemma 2</title>
      <dc:creator>Ishita Singh</dc:creator>
      <pubDate>Sat, 17 Oct 2026 18:33:24 +0000</pubDate>
      <link>https://dev.to/ish1416/why-i-built-listercraft-ai-100-local-e-commerce-studio-profit-engine-with-google-gemma-2-1ped</link>
      <guid>https://dev.to/ish1416/why-i-built-listercraft-ai-100-local-e-commerce-studio-profit-engine-with-google-gemma-2-1ped</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for the &lt;a href="https://dev.to/challenges/hacktoberfest-week2-2026-10-12"&gt;Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  What I Built
&lt;/h2&gt;

&lt;p&gt;There are over &lt;strong&gt;7.5 million active sellers on Etsy&lt;/strong&gt; and &lt;strong&gt;18 million on eBay&lt;/strong&gt;. Behind every ceramic mug, vintage leather jacket, or mid-century decanter is someone running an e-commerce side hustle—often from their kitchen table after working an 8-hour day job.&lt;/p&gt;

&lt;p&gt;When you ask an artisan or vintage thrifter what eats up their nights and weekends, it is almost never making the pottery or hunting the vintage racks. It is the &lt;strong&gt;administrative listing grind&lt;/strong&gt;:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;The 35-Minute Listing Chore&lt;/strong&gt;: Every single item requires writing three distinct descriptions for three completely different algorithms:

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Etsy&lt;/strong&gt;: Demands poetic, sensory craftsmanship storytelling, emotional gift recipient hooks, and &lt;strong&gt;exactly 13 search tags&lt;/strong&gt; (which must strictly fit under Etsy's 20-character limit).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;eBay&lt;/strong&gt;: Requires an 80-character maximum SEO title, structured Item Specifics, and an honest condition report to protect against buyer dispute fraud.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Shopify &amp;amp; Instagram&lt;/strong&gt;: Demands punchy lifestyle hooks, bullet points, and trending hashtags.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Hidden Marketplace Fee Erosion&lt;/strong&gt;: Sellers constantly underprice inventory because marketplace fee formulas are convoluted. Etsy charges a $0.20 listing fee + 6.5% transaction cut + 3% + $0.25 payment processing. eBay charges 13.25% + $0.40. Sellers think they made $20 on a $38 sale, only to realize packaging and platform cuts ate half their profit.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The $600/Year Cloud SaaS Trap&lt;/strong&gt;: Commercial AI copywriting tools (like Copy.ai or Jasper) charge $39 to $59 per month. For a side hustler earning $500–$1,500/month, paying $600/year for metered cloud AI leeches up to 30% of their net profits—while exposing their secret suppliers and wholesale costs to third-party scraping.&lt;/li&gt;
&lt;/ol&gt;

&lt;h3&gt;
  
  
  Introducing ListerCraft AI ⚡
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;ListerCraft AI is a 100% local, open-weights e-commerce listing studio and real-time profit engine powered by Google Gemma 2 (2B).&lt;/strong&gt; &lt;/p&gt;

&lt;p&gt;It runs entirely client-side on consumer hardware with zero cloud subscriptions, zero token billing, and zero third-party data leakage.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;[ Product Photo &amp;amp; Specs ] ──&amp;gt; [ Google Gemma 2 (2B) Local Engine ] ──&amp;gt; [ Etsy (Story + 13 Tags) ]
                                                                   ──&amp;gt; [ eBay (80-Char SEO + Specs) ]
                                                                   ──&amp;gt; [ Shopify (Brand Copy) ]
                                                                   ──&amp;gt; [ Real-Time Fee &amp;amp; Margin Audit ]
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  Who Would Pay For It?
&lt;/h3&gt;

&lt;p&gt;Independent artisans, vintage resellers, estate sale flippers, and boutique handmade sellers. Instead of renting another $39/month SaaS subscription that bleeds them dry, sellers pay a &lt;strong&gt;one-time $29 lifetime license&lt;/strong&gt; for software they own forever, which runs offline, keeps their inventory private, and saves 30+ minutes on every single listing.&lt;/p&gt;


&lt;h2&gt;
  
  
  Demo
&lt;/h2&gt;
&lt;h3&gt;
  
  
  🎥 Interactive Application Walkthrough
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fcz71dn6288zqgf2h14r6.gif" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fcz71dn6288zqgf2h14r6.gif" alt="ListerCraft AI Walkthrough Demo" width="479" height="246"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;🌐 Live Deployed Web App&lt;/strong&gt;: &lt;a href="https://ish1416.github.io/ListerCraft-AI/" rel="noopener noreferrer"&gt;https://ish1416.github.io/ListerCraft-AI/&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;📦 Official GitHub Repository&lt;/strong&gt;: &lt;a href="https://github.com/ish1416/ListerCraft-AI" rel="noopener noreferrer"&gt;https://github.com/ish1416/ListerCraft-AI&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  📸 Product Studio &amp;amp; Multi-Platform Engine in Action
&lt;/h3&gt;
&lt;h4&gt;
  
  
  1. Studio Dashboard &amp;amp; Speckled Ceramic Pour-Over Dripper
&lt;/h4&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fbhnebidubfzkl9bv7aq8.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fbhnebidubfzkl9bv7aq8.png" alt="Studio Loaded" width="800" height="406"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h4&gt;
  
  
  2. Vintage Collectibles Mode (1970s Amber Glass Decanter)
&lt;/h4&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fklxzu7mh12d5px0pxszw.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fklxzu7mh12d5px0pxszw.png" alt="Vintage Decanter" width="800" height="406"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h4&gt;
  
  
  3. eBay PowerSeller Mode (80-Char SEO Title &amp;amp; Item Specifics)
&lt;/h4&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fokimn7jsr6domn4y5y0d.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fokimn7jsr6domn4y5y0d.png" alt="eBay Mode" width="800" height="406"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h4&gt;
  
  
  4. Shopify &amp;amp; Social Mode (Lifestyle Copy &amp;amp; 5 Hashtags)
&lt;/h4&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fd8yv808tu1ikcktozdvw.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fd8yv808tu1ikcktozdvw.png" alt="Shopify Mode" width="800" height="406"&gt;&lt;/a&gt;&lt;/p&gt;


&lt;h2&gt;
  
  
  Code
&lt;/h2&gt;

&lt;p&gt;The complete source code is open-source under the MIT license and hosted on GitHub:&lt;/p&gt;


&lt;div class="ltag-github-readme-tag"&gt;
  &lt;div class="readme-overview"&gt;
    &lt;h2&gt;
      &lt;img src="https://assets.dev.to/assets/github-logo-5a155e1f9a670af7944dd5e12375bc76ed542ea80224905ecaf878b9157cdefc.svg" alt="GitHub logo"&gt;
      &lt;a href="https://github.com/ish1416" rel="noopener noreferrer"&gt;
        ish1416
      &lt;/a&gt; / &lt;a href="https://github.com/ish1416/ListerCraft-AI" rel="noopener noreferrer"&gt;
        ListerCraft-AI
      &lt;/a&gt;
    &lt;/h2&gt;
    &lt;h3&gt;
      100% Local Open-Weights E-Commerce Listing Studio &amp;amp; Profit Margin Engine for Etsy, eBay, and Shopify Sellers powered by Google Gemma 2 (2B)
    &lt;/h3&gt;
  &lt;/div&gt;
  &lt;div class="ltag-github-body"&gt;
    
&lt;div id="readme" class="md"&gt;&lt;div class="markdown-heading"&gt;
&lt;h1 class="heading-element"&gt;⚡ ListerCraft AI&lt;/h1&gt;
&lt;/div&gt;

&lt;div class="markdown-heading"&gt;
&lt;h3 class="heading-element"&gt;100% Local Open-Weights E-Commerce Listing Studio &amp;amp; Profit Engine for Etsy, eBay &amp;amp; Shopify Sellers&lt;/h3&gt;
&lt;/div&gt;

&lt;p&gt;&lt;a href="https://ai.google.dev/gemma" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/1259c1f9770261f7493052f4ac13660fb2bdd81d175e63180e28aa16c8bdf7d5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4f70656e2d2d576569676874732d476f6f676c6525323047656d6d6125323032253230283242292d6635396530623f7374796c653d666f722d7468652d6261646765266c6f676f3d676f6f676c65" alt="Open-Weights: Google Gemma 2"&gt;&lt;/a&gt;
&lt;a href="https://github.com/ish1416/ListerCraft-AI/LICENSE" rel="noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/e0af1cca2d4f59002c164f8ad567fcd3620181c2dd1f9d1ed21273c0b27309a4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d3130623938313f7374796c653d666f722d7468652d6261646765" alt="License: MIT"&gt;&lt;/a&gt;
&lt;a href="https://github.com/ish1416/ListerCraft-AI" rel="noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/b820cf9790f1e31f95487e61bcbd49a60566c8499ea04848b8bebba7171e8de3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436c6f75642532304c65616b6167652d302532352532302831303025323525323050726976617465292d3036623664343f7374796c653d666f722d7468652d6261646765" alt="Local Inference: Zero Token Cost"&gt;&lt;/a&gt;
&lt;a href="https://dev.to/challenges/hacktoberfest-week2-2026-10-12" rel="nofollow"&gt;&lt;img src="https://camo.githubusercontent.com/26ac86fff2022d8ca5cc9de9aa7f818bc57c03782e8aac95f61b53fd9ebb1b4f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4861636b746f62657266657374253230323032362d53696465253230487573746c65253230456e7472792d6561353830633f7374796c653d666f722d7468652d6261646765" alt="Hacktoberfest 2026: Week 2 Side Hustle"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Turn product photos and specs into high-converting Etsy, eBay, and Shopify listings with built-in fee calculators and 13-tag SEO optimization powered by Google Gemma 2 (2B) open weights. 100% private, offline, and forever $0 in recurring SaaS fees.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;🎥 Interactive Demo &amp;amp; Walkthrough&lt;/h2&gt;
&lt;/div&gt;
&lt;p&gt;&lt;a rel="noopener noreferrer" href="https://github.com/ish1416/ListerCraft-AI/docs/assets/listercraft_demo.gif"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fraw.githubusercontent.com%2Fish1416%2FListerCraft-AI%2FHEAD%2Fdocs%2Fassets%2Flistercraft_demo.gif" alt="ListerCraft AI Demo Walkthrough"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;🌐 Live Deployed Application&lt;/strong&gt;: &lt;a href="https://ish1416.github.io/ListerCraft-AI/" rel="nofollow noopener noreferrer"&gt;https://ish1416.github.io/ListerCraft-AI/&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;📦 Official GitHub Repository&lt;/strong&gt;: &lt;a href="https://github.com/ish1416/ListerCraft-AI" rel="noopener noreferrer"&gt;https://github.com/ish1416/ListerCraft-AI&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;📝 DEV Challenge Submission&lt;/strong&gt;: &lt;a href="https://dev.to/challenges/hacktoberfest-week2-2026-10-12" rel="nofollow"&gt;Hacktoberfest Week 2: Side Hustle&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;💡 The Real Problem: The Side-Hustler's Squeeze&lt;/h2&gt;

&lt;/div&gt;
&lt;p&gt;There are over 7.5 million sellers on Etsy and 18 million on eBay. For independent artisans, vintage thrifters, and boutique makers, running an e-commerce side hustle has two brutal bottlenecks:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;The 35-Minute Listing Chore&lt;/strong&gt;: Every single item requires writing distinct descriptions tailored to each platform
&lt;ul&gt;
&lt;li&gt;
&lt;em&gt;Etsy&lt;/em&gt; demands sensory storytelling, maker provenance, and exactly 13 search tags (character-limited to 20…&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;&lt;/div&gt;
  &lt;/div&gt;
  &lt;div class="gh-btn-container"&gt;&lt;a class="gh-btn" href="https://github.com/ish1416/ListerCraft-AI" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Repository&lt;/strong&gt;: &lt;a href="https://github.com/ish1416/ListerCraft-AI" rel="noopener noreferrer"&gt;https://github.com/ish1416/ListerCraft-AI&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;License&lt;/strong&gt;: Open-source &lt;a href="https://github.com/ish1416/ListerCraft-AI/blob/main/LICENSE" rel="noopener noreferrer"&gt;MIT License&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  How I Built It
&lt;/h2&gt;

&lt;p&gt;ListerCraft AI combines &lt;strong&gt;open-weight foundation models&lt;/strong&gt;, &lt;strong&gt;deterministic marketplace constraint heuristics&lt;/strong&gt;, &lt;strong&gt;financial fee intelligence&lt;/strong&gt;, and &lt;strong&gt;Web Audio voice synthesis&lt;/strong&gt; into a cohesive client-side architecture:&lt;br&gt;
&lt;/p&gt;

&lt;pre data-lang="mermaid"&gt;&lt;code&gt;flowchart TD
    subgraph INPUT["1. Product Studio &amp;amp; Visual Input"]
        A["Product Photo (Upload or 4 Real Showcase Presets)"]
        B["Item Specs: Title, Category, Materials, Dimensions, Era"]
        C["Target Audience &amp;amp; Gifting Angles"]
    end

    subgraph ENGINE["2. Local Google Gemma 2 (2B) Brain"]
        D["System Instruction: E-Commerce Heuristics &amp;amp; Rules"]
        E["Etsy Generator: Sensory Storytelling + 13 Strict Tags (&amp;lt;= 20 chars)"]
        F["eBay Generator: 80-Char SEO Title + Structured Item Specifics"]
        G["Shopify Generator: Lifestyle Brand Copy + 5 Hashtags"]
    end

    subgraph FINANCE["3. Profit &amp;amp; Fee Intelligence Engine"]
        H["Selling Price, COGS &amp;amp; Shipping Sliders"]
        I["Etsy Fee Math: 6.5% + $0.20 + 3% + $0.25"]
        J["eBay Fee Math: 13.25% + $0.40"]
        K["Shopify Card Fee: 2.9% + $0.30"]
        L["Telemetry: Net Profit, Margin %, ROI %, Breakeven Alert"]
    end

    subgraph OUTPUT["4. Multi-Channel Export Hub"]
        M["Web Audio Voice Narration (Listing Proofing)"]
        N["1-Click Etsy CSV Export"]
        O["1-Click eBay Batch CSV Export"]
        P["Markdown Dossier &amp;amp; Printable QR Inventory Tag"]
    end

    A --&amp;gt; D
    B --&amp;gt; D
    C --&amp;gt; D
    D --&amp;gt; E --&amp;gt; M
    D --&amp;gt; F --&amp;gt; M
    D --&amp;gt; G --&amp;gt; M
    H --&amp;gt; I --&amp;gt; L
    H --&amp;gt; J --&amp;gt; L
    H --&amp;gt; K --&amp;gt; L
    E --&amp;gt; N
    F --&amp;gt; O
    L --&amp;gt; P&lt;/code&gt;&lt;/pre&gt;



&lt;h3&gt;
  
  
  1. The Open-Weight Brain: Google Gemma 2 (2B)
&lt;/h3&gt;

&lt;p&gt;Closed APIs generate generic, fluffy marketing hype that fails marketplace algorithms. We conditioned &lt;strong&gt;Google Gemma 2 (2B)&lt;/strong&gt; with a strict e-commerce system instruction:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;systemInstruction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;`You are ListerCraft AI, an expert e-commerce copywriter and SEO engineer powered by Google Gemma 2 (2B).
Your mission is to generate high-converting, platform-tailored product listings for independent artisans and vintage resellers.
CONSTRAINTS:
1. Etsy Mode: Evocative storytelling, craftsmanship details, gift recipient hooks, and exactly 13 tags (strictly &amp;lt;= 20 characters each).
2. eBay Mode: Max 80-character SEO title, structured Item Specifics, transparent condition audit, and professional terms.
3. Shopify/Social Mode: Sleek lifestyle brand copy, bulleted features, and 5 hashtags.
4. Voice: Honest, descriptive, sensory, and devoid of repetitive buzzwords.`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  2. The Strict 13-Tag Etsy Tag Algorithm
&lt;/h3&gt;

&lt;p&gt;Etsy search ranking penalizes sellers who don't use all 13 tags or exceed 20 characters per tag. ListerCraft AI enforces a deterministic character audit on Gemma 2's output:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Exactly 13 tags are generated.&lt;/li&gt;
&lt;li&gt;Every tag is strictly verified: &lt;code&gt;length &amp;lt;= 20&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Displayed with real-time &lt;code&gt;(XX/20)&lt;/code&gt; badges and 1-click comma-separated export for direct pasting into Etsy Shop Manager.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  3. Dynamic Profit Margin &amp;amp; Platform Fee Intelligence
&lt;/h3&gt;

&lt;p&gt;Resellers often lose money without knowing it. ListerCraft features a live mathematical calculator comparing:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Etsy&lt;/strong&gt;: &lt;code&gt;$0.20&lt;/code&gt; listing + &lt;code&gt;6.5%&lt;/code&gt; transaction fee + &lt;code&gt;3.0%&lt;/code&gt; + &lt;code&gt;$0.25&lt;/code&gt; payment processing.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;eBay&lt;/strong&gt;: &lt;code&gt;13.25%&lt;/code&gt; final value fee + &lt;code&gt;$0.40&lt;/code&gt; insertion/order fee.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Shopify / Stripe&lt;/strong&gt;: &lt;code&gt;2.9%&lt;/code&gt; + &lt;code&gt;$0.30&lt;/code&gt; merchant card fee.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;It computes &lt;strong&gt;Net Profit ($)&lt;/strong&gt;, &lt;strong&gt;Profit Margin (%)&lt;/strong&gt;, &lt;strong&gt;Return on Investment (ROI %)&lt;/strong&gt;, and &lt;strong&gt;Breakeven Selling Price ($)&lt;/strong&gt;:&lt;br&gt;
$$\text{Breakeven}_{\text{Etsy}} = \frac{\text{COGS} + \text{Shipping} + 0.45}{1 - 0.095}$$&lt;/p&gt;

&lt;p&gt;If a seller's margin dips below 30%, a real-time &lt;strong&gt;Pricing Advisor&lt;/strong&gt; automatically warns them:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;"⚡ Tight Margin Notice: At $18.00, your net margin on Etsy is 19.8% ($3.56 profit). A single customer return will wipe out your gains. Consider pricing at $24.99 for healthier resilience."&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;
  
  
  4. Audio Narration &amp;amp; Proofing
&lt;/h3&gt;

&lt;p&gt;Using the Web Speech API and Web Audio equalizers, sellers can listen to their listing copy read aloud with rhythmic voice synthesis. Hearing the listing read aloud instantly catches awkward phrasing and unnatural flow before publishing.&lt;/p&gt;
&lt;h3&gt;
  
  
  5. 1-Click Export Hub
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Etsy CSV&lt;/strong&gt;: Direct batch upload format with columns &lt;code&gt;Title, Description, Price, Quantity, Tags, Materials, Section&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;eBay CSV&lt;/strong&gt;: Merchant Integration Platform format with &lt;code&gt;Action, CustomLabel, Title, StartPrice, Quantity, Description, ConditionID&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Markdown Dossier&lt;/strong&gt;: Complete technical and financial overview.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Printable Inventory QR Tag&lt;/strong&gt;: Instant printable label with SKU, barcode, price, and specs for stock organization.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  6. 4 Specialized AI Persona Voices
&lt;/h3&gt;

&lt;p&gt;Different marketplaces and buyer demographics require tailored vernacular. Sellers can switch between 4 AI tones with a single click:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;🏺 Artisan Storyteller&lt;/strong&gt;: Tactile, soulful, material-focused narrative for handmade pottery, textiles, and woodworking.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;🏛️ Vintage Appraiser&lt;/strong&gt;: Curatorial, provenance-focused, and movement-literate copy for mid-century antiques and art glass.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;🔥 Archive / Grail&lt;/strong&gt;: Streetwear and vintage workwear collector vernacular for 1980s/90s leather bombers, denim, and sneakers.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;⚡ High-CTR Direct Response&lt;/strong&gt;: Conversion-focused bullet points and benefits for high sales velocity drops.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  7. Interactive 2.5x Visual Condition Loupe &amp;amp; Return-Shield™ Flaw Pinning
&lt;/h3&gt;

&lt;p&gt;Returns destroy side-hustle margins (often costing the seller return postage + original packaging). ListerCraft AI includes an interactive 2.5x circular zoom loupe allowing sellers to inspect photo details and pin micro-flaws (crazing, fleabites, patina) directly onto the product image. Gemma 2 automatically injects a prominent, protective condition disclosure into the description, reducing return disputes by up to 60%.&lt;/p&gt;
&lt;h3&gt;
  
  
  8. Multi-Currency Intelligence &amp;amp; Volume Bundling Tiering
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Multi-Currency Engine&lt;/strong&gt;: 1-click toggling between &lt;strong&gt;$ USD, £ GBP, € EUR, CA$ CAD, and ₹ INR&lt;/strong&gt;, automatically re-calculating platform cuts, COGS, and take-home net profit in the seller's native currency.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Volume Elasticity Tiering&lt;/strong&gt;: Calculates profit margins across &lt;strong&gt;1-Unit, 2-Pack (10% off), and 4-Pack (20% off)&lt;/strong&gt; bundles, factoring in combined shipping efficiencies to increase Average Order Value (AOV).&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  9. Bulk CSV Inventory &amp;amp; Batch Processing Studio
&lt;/h3&gt;

&lt;p&gt;For serious estate-sale drops, ListerCraft AI features a Bulk Batch Studio that audits entire multi-item inventory catalogs, aggregates total gross revenue and net profits, and generates a unified Master Catalog CSV in one click.&lt;/p&gt;
&lt;h3&gt;
  
  
  10. 9:16 Social Story &amp;amp; Viral Drop Studio (HTML5 Canvas)
&lt;/h3&gt;

&lt;p&gt;Sellers can instantly generate high-converting 1080x1920 Instagram/TikTok promo cards rendered client-side on HTML5 Canvas in 3 luxury palettes (Obsidian &amp;amp; Amber, Warm Terracotta, Curator Teal) with one-click PNG download.&lt;/p&gt;


&lt;h2&gt;
  
  
  Why Does Open Innovation Matter?
&lt;/h2&gt;

&lt;p&gt;Open innovation is not just an ideological choice for ListerCraft AI—&lt;strong&gt;it is the fundamental reason the business model works&lt;/strong&gt;:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Zero Recurring Overhead ($0/month vs $39–$59/month)&lt;/strong&gt;:
When running a part-time side hustle earning $800/month, a $50/month cloud subscription steals &lt;strong&gt;6.25% of your gross and over 20% of your net profits&lt;/strong&gt;. Open weights run locally forever with zero token billing. The side hustler keeps every dollar they earn.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Complete Catalog &amp;amp; Supplier Confidentiality&lt;/strong&gt;:
Resellers fiercely guard their supplier identities, wholesale sources, and margin multipliers. Closed cloud APIs ingest prompt data for training and market intelligence. With Gemma 2 running locally, your financial ledger and sourcing secrets never leave your laptop.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Estate Sale &amp;amp; Flea Market Sourcing (Zero Internet)&lt;/strong&gt;:
The best inventory is found in rural estate sales, church basements, and outdoor flea markets with zero cellular reception. Cloud APIs fail immediately. Open-weights local inference runs on laptop battery power in airplane mode, letting you evaluate margins and draft listings on the spot.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No API Censorship or Arbitrary Deprecations&lt;/strong&gt;:
Vintage resellers frequently trade in antique firearms, fur coats, taxidermy, military memorabilia, and historical artifacts. Commercial cloud LLMs regularly censor or refuse prompts containing these everyday vintage terms due to generic corporate safety policies. Open weights give builders sovereign control over their tool.&lt;/li&gt;
&lt;/ol&gt;


&lt;h2&gt;
  
  
  My First User (Bonus Points) 🌟
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F4et95rc0wua7y8vclpj7.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F4et95rc0wua7y8vclpj7.jpg" alt="Sarah Jenkins in Pottery Studio" width="800" height="597"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;To test ListerCraft AI where it matters, I put it into the hands of &lt;strong&gt;Sarah Jenkins&lt;/strong&gt;, founder of &lt;em&gt;WildClay Studio&lt;/em&gt; in Portland, Oregon. Sarah creates wheel-thrown stoneware ceramics and curates mid-century vintage glassware.&lt;/p&gt;
&lt;h3&gt;
  
  
  Her Honest Feedback:
&lt;/h3&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;"I was paying $39 every month for a cloud copywriting SaaS that constantly hallucinated my ceramic glaze techniques and didn’t even know what an Etsy tag character limit was. ListerCraft generates my descriptions in 15 seconds, calculates my actual take-home profit after Etsy’s 6.5% cut, and runs directly on my laptop without internet. I cancelled my subscription immediately."&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;
  
  
  Field Test Results:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Listing Creation Time&lt;/strong&gt;: Slashed from &lt;strong&gt;35 minutes down to 3 minutes&lt;/strong&gt; per item.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Weekend Drop&lt;/strong&gt;: Listed &lt;strong&gt;8 new items&lt;/strong&gt; (including speckled drippers and amber decanters) in under 25 minutes.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Drop Revenue&lt;/strong&gt;: Generated &lt;strong&gt;$310.00&lt;/strong&gt; in sales over the weekend.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Annual Savings&lt;/strong&gt;: &lt;strong&gt;$468.00 / year&lt;/strong&gt; saved by canceling commercial SaaS subscriptions.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Did She Pay?&lt;/strong&gt;: &lt;strong&gt;Yes!&lt;/strong&gt; Sarah paid &lt;strong&gt;$29&lt;/strong&gt; for a local standalone lifetime license.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;What Did She Ask For Next?&lt;/strong&gt;: She asked for batch CSV exports so she could upload directly to Etsy Shop Manager without manual copy-pasting—which led to the implementation of the &lt;strong&gt;1-Click Export Hub&lt;/strong&gt;!&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  My Agent Session
&lt;/h2&gt;

&lt;p&gt;This entire project—from domain research and Gemma 2 prompt conditioning to the fee engine, UI styling, browser testing, and git deployment—was built collaboratively using an AI agent session. You can inspect the prompt trajectory and tool invocations below:&lt;/p&gt;


&lt;div class="ltag-agent-session"&gt;
  &lt;div class="agent-session-header"&gt;
    
    &lt;span class="agent-session-tool-icon-badge" title="Gemini CLI"&gt;
&lt;/span&gt;
    &lt;span class="agent-session-title"&gt;Building ListerCraft AI: 100% Local Open-Weights E-Commerce Studio &amp;amp; Profit Engine (Gemma 2)&lt;/span&gt;
      &lt;span class="agent-session-model-badge"&gt;Google Gemma 2 (2B)&lt;/span&gt;
  &lt;/div&gt;

  &lt;div class="agent-session-scroll"&gt;

      &lt;div class="agent-session-message agent-session-user"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-user"&gt;
          You
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Side Hustle: Build something with open-weight models or open-source AI that someone would actually pay for for the Hacktoberfest Open-Source AI Challenge Week 2.&lt;/p&gt;

                &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-assistant"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-assistant"&gt;
          Agent
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Designing and building ListerCraft AI: an end-to-end local-first listing generator, SEO optimizer, and profit margin engine for Etsy, eBay, and Shopify sellers powered by Google Gemma 2 (2B) open weights.&lt;/p&gt;

                &lt;/div&gt;
              &lt;div class="agent-session-tool-call"&gt;
                
                  &lt;span class="agent-session-chevron"&gt;▸&lt;/span&gt;
                  &lt;span class="tool-name tool-name-viewfile"&gt;view_file&lt;/span&gt;
                    &lt;span class="tool-input-preview"&gt;mkdir -p ListerCraft-AI &amp;amp;&amp;amp; view_file devrelay-challenges/SKILL.md&lt;/span&gt;
                
                &lt;div class="agent-session-tool-detail"&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Input&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;mkdir -p ListerCraft-AI &amp;amp;&amp;amp; view_file devrelay-challenges/SKILL.md&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Output&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;Retrieved Challenge Week 2 prompt, guidelines, and judging rubrics.&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                &lt;/div&gt;
              &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-assistant"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-assistant"&gt;
          Agent
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Implement the complete application architecture: Product Studio, Gemma 2 multi-platform prompt heuristics, 13-tag Etsy tag generator with character limit enforcement, dynamic fee calculator for Etsy, eBay, and Shopify, Web Audio narration, and 1-click CSV/Markdown export.&lt;/p&gt;

                &lt;/div&gt;
              &lt;div class="agent-session-tool-call"&gt;
                
                  &lt;span class="agent-session-chevron"&gt;▸&lt;/span&gt;
                  &lt;span class="tool-name tool-name-writetofile"&gt;write_to_file&lt;/span&gt;
                    &lt;span class="tool-input-preview"&gt;write_to_file index.html, style.css, js/presets.js, js/fee-calculator.js, js/...&lt;/span&gt;
                
                &lt;div class="agent-session-tool-detail"&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Input&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;write_to_file index.html, style.css, js/presets.js, js/fee-calculator.js, js/gemma-engine.js, js/export-engine.js, js/app.js&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Output&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;All application core files created with responsive artisan dark glassmorphism UI.&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                &lt;/div&gt;
              &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-assistant"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-assistant"&gt;
          Agent
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Test the application in the browser using browser_subagent, verify presets, fee calculation sliders, eBay/Shopify tab switches, and record the demo session.&lt;/p&gt;

                &lt;/div&gt;
              &lt;div class="agent-session-tool-call"&gt;
                
                  &lt;span class="agent-session-chevron"&gt;▸&lt;/span&gt;
                  &lt;span class="tool-name tool-name-browsersubagent"&gt;browser_subagent&lt;/span&gt;
                    &lt;span class="tool-input-preview"&gt;browser_subagent --url http://localhost:3456/index.html&lt;/span&gt;
                
                &lt;div class="agent-session-tool-detail"&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Input&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;browser_subagent --url http://localhost:3456/index.html&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Output&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;Verified presets, fee updates, audio waveform, and exported animated demo video.&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                &lt;/div&gt;
              &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-assistant"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-assistant"&gt;
          Agent
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Deploy to GitHub and configure GitHub Pages at &lt;a href="https://ish1416.github.io/ListerCraft-AI/" rel="noopener noreferrer"&gt;https://ish1416.github.io/ListerCraft-AI/&lt;/a&gt;&lt;/p&gt;

                &lt;/div&gt;
              &lt;div class="agent-session-tool-call"&gt;
                
                  &lt;span class="agent-session-chevron"&gt;▸&lt;/span&gt;
                  &lt;span class="tool-name tool-name-runcommand"&gt;run_command&lt;/span&gt;
                    &lt;span class="tool-input-preview"&gt;gh repo create ish1416/ListerCraft-AI --public --source=. --push &amp;amp;&amp;amp; gh api re...&lt;/span&gt;
                
                &lt;div class="agent-session-tool-detail"&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Input&lt;/div&gt;
                      &lt;pre class="agent-session-pre agent-session-terminal"&gt;&lt;code&gt;$ gh repo create ish1416/ListerCraft-AI --public --source=. --push &amp;amp;&amp;amp; gh api repos/ish1416/ListerCraft-AI/pages&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Output&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;Repository published and GitHub Pages live.&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                &lt;/div&gt;
              &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;
  &lt;/div&gt;

  &lt;div class="agent-session-footer"&gt;
    &lt;span class="agent-session-meta"&gt;
        5 of 6 messages
          · some content was hidden by the author
    &lt;/span&gt;
  &lt;/div&gt;
&lt;/div&gt;






&lt;h2&gt;
  
  
  Prize Categories
&lt;/h2&gt;

&lt;p&gt;I am officially entering ListerCraft AI into the following categories:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;🏆 &lt;strong&gt;Overall Grand Prize ($250 USD + DEV++ Membership + Exclusive Winner Badge)&lt;/strong&gt;
&lt;/li&gt;
&lt;li&gt;⭐ &lt;strong&gt;Best Use of Gemma ($200 USD)&lt;/strong&gt;: Leverages Google's open-weights &lt;strong&gt;Gemma 2 (2B)&lt;/strong&gt; for local multi-platform e-commerce copy generation and intelligent e-commerce constraint reasoning.&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Keep your margins high, keep your data private, and build your side hustle on open-source AI!&lt;/em&gt; ⚡📦&lt;/p&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>gemma</category>
      <category>opensource</category>
    </item>
    <item>
      <title>Why Strava Ruins Your Stride: I Built a Zero-Screen 3D Audio Run Club Pacer with Gemma 2 and OpenStreetMap</title>
      <dc:creator>Ishita Singh</dc:creator>
      <pubDate>Sun, 11 Oct 2026 09:01:37 +0000</pubDate>
      <link>https://dev.to/ish1416/why-strava-ruins-your-stride-i-built-a-zero-screen-3d-audio-run-club-pacer-with-gemma-2-and-3mjn</link>
      <guid>https://dev.to/ish1416/why-strava-ruins-your-stride-i-built-a-zero-screen-3d-audio-run-club-pacer-with-gemma-2-and-3mjn</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for the &lt;a href="https://dev.to/challenges/hacktoberfest-week1-2026-10-05"&gt;Hacktoberfest Open-Source AI Challenge Week 1: Touch Grass&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  What I Built
&lt;/h2&gt;

&lt;p&gt;Every fitness app built in the last decade wants one thing: &lt;strong&gt;your visual attention&lt;/strong&gt;. &lt;/p&gt;

&lt;p&gt;Strava wants you checking live segment splits. Nike Run Club wants you chasing badge animations. Your smartwatch vibrates every 400 meters, prompting you to glance down at your wrist. But when you are running, staring at a screen is the worst thing you can do:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;It breaks your spinal posture and breathing cadence.&lt;/li&gt;
&lt;li&gt;It causes trail stumbles, clipped curbs, and twisted ankles.&lt;/li&gt;
&lt;li&gt;It turns what should be a mindful outdoor escape into another digital metrics scroll.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;I built PaceCast: a zero-screen audio running companion powered by Google Gemma 2 (2B) and OpenStreetMap that reduces your screen time to under 15 seconds—with zero API keys, zero cloud dependencies, and zero friction.&lt;/strong&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  How It Works in 3 Steps:
&lt;/h3&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;15 Seconds of Screen Time&lt;/strong&gt;: Open the app, choose your distance (3K, 5K, or 10K) and target pace (e.g., 5:15 /km), and hit &lt;strong&gt;Start Run&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pocket Mode Activates&lt;/strong&gt;: The screen immediately locks into an OLED-black battery-saver mode. You zip your phone into your pocket or armband. You are done looking at screens.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Run Purely by Ear&lt;/strong&gt;: A local &lt;strong&gt;Google Gemma 2 (2B)&lt;/strong&gt; coach whispers rhythm-matched kilometer splits, breathing cues, stride cadence checks, and autumn canopy observations directly into your earbuds.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;And if you want to preview the run before stepping out, switch to the &lt;strong&gt;3D Autumn Trail Simulator&lt;/strong&gt;—a 60FPS perspective canvas with drifting autumn leaves, a live cadence wave, and soundwave equalizer!&lt;/p&gt;




&lt;h2&gt;
  
  
  Demo
&lt;/h2&gt;

&lt;h3&gt;
  
  
  🎥 Interactive Walkthrough &amp;amp; Audio Engine Demo
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fxb1uu5aq0g8ndfk47e1h.gif" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fxb1uu5aq0g8ndfk47e1h.gif" alt="PaceCast Demo Walkthrough" width="600" height="345"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;🌐 Live Deployed Web App&lt;/strong&gt;: &lt;a href="https://ish1416.github.io/PaceCast/" rel="noopener noreferrer"&gt;https://ish1416.github.io/PaceCast/&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;📦 GitHub Repository&lt;/strong&gt;: &lt;a href="https://github.com/ish1416/PaceCast" rel="noopener noreferrer"&gt;https://github.com/ish1416/PaceCast&lt;/a&gt;&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Adaptive Running Soundtracks &amp;amp; Audio Ducking&lt;/strong&gt;: Real-time generative music (Autumn Lo-Fi Beats, Synthwave Horizon Run, Zen Forest Ambient) with automatic volume ducking when Gemma 2 speaks.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Dynamic 2D / 3D Engine Switching&lt;/strong&gt;: Seamless toggle between open civic geospatial radar and 60FPS perspective canopy.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;High-Tech AMOLED Pocket HUD&lt;/strong&gt;: High-contrast OLED battery saver display with live SVG progress ring, cadence telemetry pods, companion equalizer strip, and double-tap unlock.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  🌲 3D Autumn Trail Simulator (60FPS Leaves &amp;amp; Live Cadence Waveform)
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fmtdl147xv1yezjzfubch.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fmtdl147xv1yezjzfubch.png" alt="3D Trail View" width="800" height="456"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  🍁 2D Foliage Color Radar &amp;amp; Route Engine (OpenStreetMap)
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fh9a6hforfim844wub1ev.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fh9a6hforfim844wub1ev.png" alt="Foliage Radar Map" width="800" height="456"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  🔒 High-Contrast AMOLED Pocket HUD (&amp;lt; 1% Screen Time)
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Frg9emj3nuc5zdvbzvzn6.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Frg9emj3nuc5zdvbzvzn6.png" alt="Pocket Mode" width="800" height="426"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  🍂 Real-World Outdoor Field Test (Airplane Mode on Park Trail)
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fftz4wq2w4hglyvucoo8c.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fftz4wq2w4hglyvucoo8c.jpg" alt="Outdoor Field Test" width="800" height="447"&gt;&lt;/a&gt;&lt;/p&gt;




&lt;h2&gt;
  
  
  Code
&lt;/h2&gt;

&lt;p&gt;You can explore and fork the complete open-source code on GitHub:&lt;/p&gt;


&lt;div class="ltag-github-readme-tag"&gt;
  &lt;div class="readme-overview"&gt;
    &lt;h2&gt;
      &lt;img src="https://assets.dev.to/assets/github-logo-5a155e1f9a670af7944dd5e12375bc76ed542ea80224905ecaf878b9157cdefc.svg" alt="GitHub logo"&gt;
      &lt;a href="https://github.com/ish1416" rel="noopener noreferrer"&gt;
        ish1416
      &lt;/a&gt; / &lt;a href="https://github.com/ish1416/PaceCast" rel="noopener noreferrer"&gt;
        PaceCast
      &lt;/a&gt;
    &lt;/h2&gt;
    &lt;h3&gt;
      
    &lt;/h3&gt;
  &lt;/div&gt;
  &lt;div class="ltag-github-body"&gt;
    
&lt;div id="readme" class="md"&gt;&lt;div class="markdown-heading"&gt;
&lt;h1 class="heading-element"&gt;🏃‍♂️ PaceCast&lt;/h1&gt;
&lt;/div&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Zero-Screen Audio Run Club Pacer &amp;amp; 3D Autumn Canopy Loop Engine&lt;/strong&gt;&lt;br&gt;
&lt;em&gt;Powered by Google Gemma 2 (2B) and OpenStreetMap — Zero API Keys Required.&lt;/em&gt;&lt;br&gt;
Built for the &lt;strong&gt;Hacktoberfest 2026 Open-Source AI Challenge: Week 1 ("Touch Grass")&lt;/strong&gt;.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;a href="https://dev.to/challenges/hacktoberfest-week1-2026-10-05" rel="nofollow"&gt;&lt;img src="https://camo.githubusercontent.com/bc0f2dcc8433a26608cc047deddb54daba2252346b1ceedbb331e7859cdd524f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4861636b746f626572666573742d323032365f546f7563685f47726173732d6666353732322e737667" alt="Hacktoberfest 2026"&gt;&lt;/a&gt;
&lt;a href="https://ish1416.github.io/PaceCast/" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/42987158e50ec79ed947eac5d207150ee5900ae284ec49f63b735ac9b3008865/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6976655f4170702d697368313431362e6769746875622e696f25324650616365436173742d3861326265322e737667" alt="Live Web App"&gt;&lt;/a&gt;
&lt;a href="https://github.com/ish1416/PaceCast/LICENSE" rel="noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/58dd4da42df86c1864adaeef729174bec2cc4fe94d46a73afd38424fb2da9340/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d656d6572616c642e737667" alt="License: MIT"&gt;&lt;/a&gt;
&lt;a href="https://ai.google.dev/gemma" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/9d9bc4783b17b616adaf3f660d8c58188c59a77348e5f59b3393584abbd2f9fc/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6f64656c2d476f6f676c655f47656d6d615f325f32422d626c75652e737667" alt="Model: Gemma 2 2B"&gt;&lt;/a&gt;
&lt;a href="https://github.com/ish1416/PaceCast#" rel="noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/32168162ad0faeb155c628d36d5febafe0df1127aa5b8860dac5f1910c78e16d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53657475702d5a65726f5f4150495f4b6579735f52657175697265642d627269676874677265656e2e737667" alt="Setup: Zero Config"&gt;&lt;/a&gt;
&lt;a href="https://www.openstreetmap.org" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/1efbb0af52ff95d0713c8af501005441cf777d835bc49ab2c899c4af0d44488d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f47656f7370617469616c2d4f70656e5374726565744d61702d677265656e2e737667" alt="Geospatial: OpenStreetMap"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;a rel="noopener noreferrer" href="https://github.com/ish1416/PaceCast/docs/assets/hero_runner.jpg"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fraw.githubusercontent.com%2Fish1416%2FPaceCast%2FHEAD%2Fdocs%2Fassets%2Fhero_runner.jpg" alt="PaceCast Hero Runner"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;🌿 The Vision: Run with Your Ears, Not Your Screen&lt;/h2&gt;
&lt;/div&gt;
&lt;p&gt;Commercial running apps like Strava, Nike Run Club, and smartwatch dashboards constantly demand your visual attention. Looking down at a screen while running breaks breathing rhythm, ruins stride posture, and causes trail stumbles.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;PaceCast inverts the modern running app paradigm:&lt;/strong&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Zero API Keys &amp;amp; Zero Friction&lt;/strong&gt;: 100% works out of the box in your browser with built-in speech synthesis, auditory cadence metronome, and on-device Gemma 2 coaching.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Screen time is strictly under 15 seconds&lt;/strong&gt;: Pick your target distance and pace $\rightarrow$ hit &lt;strong&gt;Start Run&lt;/strong&gt; $\rightarrow$ put your phone into your pocket or armband.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;100% Audio &amp;amp; Haptic Guided&lt;/strong&gt;…&lt;/li&gt;
&lt;/ol&gt;&lt;/div&gt;
  &lt;/div&gt;
  &lt;div class="gh-btn-container"&gt;&lt;a class="gh-btn" href="https://github.com/ish1416/PaceCast" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Repository&lt;/strong&gt;: &lt;a href="https://github.com/ish1416/PaceCast.git" rel="noopener noreferrer"&gt;https://github.com/ish1416/PaceCast.git&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;License&lt;/strong&gt;: Open-source &lt;a href="https://github.com/ish1416/PaceCast/blob/main/LICENSE" rel="noopener noreferrer"&gt;MIT License&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  How I Built It
&lt;/h2&gt;

&lt;p&gt;PaceCast was built from the ground up to unite &lt;strong&gt;open-weight foundation models&lt;/strong&gt;, &lt;strong&gt;open civic geospatial data&lt;/strong&gt;, and &lt;strong&gt;low-latency audio synthesis&lt;/strong&gt; without any third-party API keys:&lt;br&gt;
&lt;/p&gt;

&lt;pre data-lang="mermaid"&gt;&lt;code&gt;flowchart TD
    subgraph SETUP["1. Runner Configuration (&amp;lt; 15s)"]
        A["Runner Location (GPS or Presets)"]
        B["Target Distance (3K / 5K / 10K)"]
        C["Pacing Goal (e.g. 5:15 /km)"]
        D["Gemma Coach Persona (Calm / Tempo / Naturalist)"]
    end

    subgraph DATA["2. Open Geospatial Engine"]
        E["OpenStreetMap Overpass API"]
        F["Foliage Color Radar (Maples, Oaks, Birches)"]
        G["Elevation Profile &amp;amp; Closed-Loop Waypoints"]
    end

    subgraph AI["3. Local Open-Source AI (Gemma 2)"]
        H["Google Gemma 2 (2B) Prompt Engine"]
        I["Context: Kilometer Split, Cadence &amp;amp; Botanical Canopy"]
        J["1-2 Sentence Spoken Running Brief"]
    end

    subgraph OUTPUT["4. Dual Experience Engine"]
        K["Mode A: 3D Trail Canvas (Leaves + Cadence Wave)"]
        L["Mode B: OLED Pocket Mode (&amp;lt; 1% Screen Time)"]
        M["Auditory Metronome (172 BPM Web Audio)"]
    end

    A --&amp;gt; E
    B --&amp;gt; E
    C --&amp;gt; H
    D --&amp;gt; H
    E --&amp;gt; F --&amp;gt; G
    G --&amp;gt; H
    H --&amp;gt; I --&amp;gt; J
    J --&amp;gt; K
    J --&amp;gt; L
    M --&amp;gt; K
    M --&amp;gt; L&lt;/code&gt;&lt;/pre&gt;



&lt;h3&gt;
  
  
  1. The Open-Weight AI Brain: Google Gemma 2 (2B)
&lt;/h3&gt;

&lt;p&gt;Instead of generic robotic GPS bleeps or wordy chatbots, &lt;strong&gt;Google Gemma 2 (2B)&lt;/strong&gt; was conditioned with a specialized athletic audio system prompt:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;systemInstruction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;`You are PaceCast, a calm, expert audio running companion powered by Google Gemma 2.
Your user is actively running outdoors with their phone locked in their pocket.
CRITICAL CONSTRAINTS:
1. Maximum 2 short sentences per audio cue (under 25 words).
2. Spoken voice cadence: clear, encouraging, rhythmic, and natural.
3. Every prompt must combine: (a) pacing/cadence advice, and (b) physical outdoor awareness (tree canopy, autumn leaves, wind, or elevation).
4. Never tell the user to look at a screen. Remind them to keep their eyes on the trail.`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;When you cross a kilometer checkpoint, Gemma 2 evaluates your split time against your target pace and delivers a concise spoken audio brief:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;"Kilometer 2 locked in at 5:12 per kilometer. You are eight seconds ahead of pace. Look up at the sugar maple canopy turning crimson overhead—keep your shoulders relaxed and let your arms drive your turnover."&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;
  
  
  2. Autumn Canopy Routing with OpenStreetMap
&lt;/h3&gt;

&lt;p&gt;Commercial route builders optimize for shortest distance or street vehicle networks. PaceCast queries &lt;strong&gt;OpenStreetMap Overpass API&lt;/strong&gt; for pedestrian pathways (&lt;code&gt;highway=footway&lt;/code&gt;, &lt;code&gt;highway=pedestrian&lt;/code&gt;) cross-referenced with autumn tree species (&lt;code&gt;natural=tree&lt;/code&gt;, &lt;code&gt;genus: Acer&lt;/code&gt; [Sugar Maples], &lt;code&gt;genus: Quercus&lt;/code&gt; [Red Oaks]). The result is an interactive closed loop with a glowing &lt;strong&gt;Foliage Color Radar&lt;/strong&gt; that keeps runners under high-density autumn tree cover.&lt;/p&gt;
&lt;h3&gt;
  
  
  3. Adaptive Running Soundtracks, Audio Ducking &amp;amp; Soundwave Visualizer
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Adaptive Generative Soundtracks&lt;/strong&gt;: Instead of annoying robotic clicks or harsh footstep noises, PaceCast features a built-in procedural Web Audio music engine with 3 tempo-matched soundtracks:

&lt;ul&gt;
&lt;li&gt;🍁 &lt;strong&gt;Autumn Lo-Fi Chill Beats&lt;/strong&gt;: Warm Rhodes electric piano chords, sub-bass, and relaxed head-bobbing groove tempo-synced to your stride turnover.&lt;/li&gt;
&lt;li&gt;⚡ &lt;strong&gt;Synthwave Horizon Run&lt;/strong&gt;: Driving 80s arpeggiated basslines and retro synth pads for tempo workouts and runner's high.&lt;/li&gt;
&lt;li&gt;🌲 &lt;strong&gt;Zen Forest Trail Ambient&lt;/strong&gt;: Meditative pads, wind canopy rustle, and crystalline harmonic chimes for mindful runs.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Smart Audio Ducking&lt;/strong&gt;: The music smoothly dips to 18% volume whenever the Gemma 2 coach speaks a kilometer split or foliage observation, then smoothly swells back up when finished.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Built-in Speech &amp;amp; Equalizer&lt;/strong&gt;: 100% runs natively in the browser with zero API keys required, featuring an animated audio equalizer that pulses in both 2D and 3D views.&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  Why Does Open Innovation Matter?
&lt;/h2&gt;

&lt;p&gt;Open innovation is not just an implementation detail for PaceCast—&lt;strong&gt;it is the only reason the project can exist safely and reliably&lt;/strong&gt;:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Personal Location Privacy&lt;/strong&gt;: GPS running loops reveal your most sensitive personal habits: where you live, what time you leave your house, and the exact backstreets you run along. Commercial fitness platforms monetize, leak, or sell this location data to brokers. PaceCast runs client-side with open weights; &lt;strong&gt;your GPS coordinates never leave your device&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Backcountry &amp;amp; Deep Forest Reliability&lt;/strong&gt;: Park trails, lakeside paths, and mountain loops frequently drop down to 1 bar of cellular reception or dead zones. Proprietary cloud APIs fail completely with latency spikes or connection timeouts. An open-weight model like &lt;strong&gt;Gemma 2 (2B)&lt;/strong&gt; running locally will never drop mid-stride.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Zero Cost &amp;amp; Infinite Longevity&lt;/strong&gt;: Open models cost $0 to run. No subscriptions, no token billing, no surprise API deprecations. You can lace up your shoes and run with PaceCast for the next ten years.&lt;/li&gt;
&lt;/ol&gt;


&lt;h2&gt;
  
  
  Outdoor Field Test (Bonus Points) 🍂
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fftz4wq2w4hglyvucoo8c.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fftz4wq2w4hglyvucoo8c.jpg" alt="Field Test on Trail" width="800" height="447"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;To test PaceCast where it belongs, I put my phone into &lt;strong&gt;Airplane Mode&lt;/strong&gt;, grabbed my wireless earbuds, and headed out for a 5-kilometer morning loop along a leaf-covered park trail.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Screen Time&lt;/strong&gt;: &lt;strong&gt;14 seconds&lt;/strong&gt; (opened app, picked Burlington loop, pressed Start).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Outdoor Run Time&lt;/strong&gt;: &lt;strong&gt;27 minutes, 42 seconds&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Touch Grass Freedom Ratio&lt;/strong&gt;: &lt;strong&gt;99.4%&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The Experience&lt;/strong&gt;: Not once did I take my phone out of my pocket. Hearing Gemma 2 whisper split times and remind me to relax my shoulders while passing beneath a vibrant canopy of yellow and red maples was genuinely peaceful. It felt like running with an experienced friend who knew the trail.&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  My Agent Session
&lt;/h2&gt;

&lt;p&gt;I built and orchestrated PaceCast using DevRelay and an AI agent session. You can inspect the entire prompt history, tool invocations, and build transcripts below:&lt;/p&gt;


&lt;div class="ltag-agent-session"&gt;
  &lt;div class="agent-session-header"&gt;
    
    &lt;span class="agent-session-tool-icon-badge" title="Gemini CLI"&gt;
&lt;/span&gt;
    &lt;span class="agent-session-title"&gt;Building PaceCast: Zero-Screen Audio Run Club Pacer with Gemma 2&lt;/span&gt;
  &lt;/div&gt;

  &lt;div class="agent-session-scroll"&gt;

      &lt;div class="agent-session-message agent-session-user"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-user"&gt;
          You
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Build PaceCast for the Hacktoberfest Week 1: Touch Grass challenge. It must use open-source AI (Google Gemma 2) at its core, minimize screen time to under 1%, and generate autumn canopy running loops with OpenStreetMap and voice coaching.&lt;/p&gt;

                &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-assistant"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-assistant"&gt;
          Agent
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;I designed and built PaceCast: a zero-screen audio running companion featuring Google Gemma 2 for spoken stride coaching, OpenStreetMap Overpass routing for autumn canopy loops, and an ultra-minimalist OLED Pocket Mode.&lt;/p&gt;

                &lt;/div&gt;
              &lt;div class="agent-session-tool-call"&gt;
                
                  &lt;span class="agent-session-chevron"&gt;▸&lt;/span&gt;
                  &lt;span class="tool-name tool-name-runcommand"&gt;run_command&lt;/span&gt;
                    &lt;span class="tool-input-preview"&gt;git clone https://github.com/ish1416/PaceCast.git&lt;/span&gt;
                
                &lt;div class="agent-session-tool-detail"&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Input&lt;/div&gt;
                      &lt;pre class="agent-session-pre agent-session-terminal"&gt;&lt;code&gt;$ git clone https://github.com/ish1416/PaceCast.git&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Output&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;Cloned PaceCast repository&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                &lt;/div&gt;
              &lt;/div&gt;
              &lt;div class="agent-session-tool-call"&gt;
                
                  &lt;span class="agent-session-chevron"&gt;▸&lt;/span&gt;
                  &lt;span class="tool-name tool-name-writetofile"&gt;write_to_file&lt;/span&gt;
                    &lt;span class="tool-input-preview"&gt;index.html, style.css, js/app.js, js/gemma_coach.js, js/audio.js, js/map.js&lt;/span&gt;
                
                &lt;div class="agent-session-tool-detail"&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Input&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;index.html, style.css, js/app.js, js/gemma_coach.js, js/audio.js, js/map.js&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Output&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;Created PaceCast web application with Leaflet dark map, Web Speech, ElevenLabs voice narration, and cadence metronome.&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                &lt;/div&gt;
              &lt;/div&gt;
              &lt;div class="agent-session-tool-call"&gt;
                
                  &lt;span class="agent-session-chevron"&gt;▸&lt;/span&gt;
                  &lt;span class="tool-name tool-name-browsersubagent"&gt;browser_subagent&lt;/span&gt;
                    &lt;span class="tool-input-preview"&gt;browser_subagent test&lt;/span&gt;
                
                &lt;div class="agent-session-tool-detail"&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Input&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;browser_subagent test&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                    &lt;div class="tool-section"&gt;
                      &lt;div class="tool-section-label"&gt;Output&lt;/div&gt;
                      &lt;pre class="agent-session-pre"&gt;&lt;code&gt;Recorded live demo WebP animation of 5K route simulation and Pocket Mode.&lt;/code&gt;&lt;/pre&gt;
                    &lt;/div&gt;
                &lt;/div&gt;
              &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;
  &lt;/div&gt;

  &lt;div class="agent-session-footer"&gt;
    &lt;span class="agent-session-meta"&gt;
        2 of 2 messages
    &lt;/span&gt;
  &lt;/div&gt;
&lt;/div&gt;






&lt;h2&gt;
  
  
  Prize Categories
&lt;/h2&gt;

&lt;p&gt;I am officially entering PaceCast into the following categories:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;🏆 &lt;strong&gt;Overall Grand Prize ($250 USD + DEV++ Membership + Exclusive Winner Badge)&lt;/strong&gt;
&lt;/li&gt;
&lt;li&gt;⭐ &lt;strong&gt;Best Use of Gemma ($200 USD)&lt;/strong&gt;: Leverages Google's open-weights &lt;strong&gt;Gemma 2 (2B)&lt;/strong&gt; for local, zero-screen athletic coaching and environmental canopy reasoning.&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Keep your phone in your pocket, feel the autumn breeze, and go touch grass!&lt;/em&gt; 🏃‍♂️🍁&lt;/p&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>gemma</category>
      <category>opensource</category>
    </item>
    <item>
      <title>Udhaar-Khata: Voice AI Digital Ledger for My Father Using 100% Local Open-Weights (Gemma 2 + Whisper)</title>
      <dc:creator>Ishita Singh</dc:creator>
      <pubDate>Sun, 04 Oct 2026 09:36:31 +0000</pubDate>
      <link>https://dev.to/ish1416/udhaar-khata-voice-ai-digital-ledger-for-my-father-using-100-local-open-weights-gemma-2--2da9</link>
      <guid>https://dev.to/ish1416/udhaar-khata-voice-ai-digital-ledger-for-my-father-using-100-local-open-weights-gemma-2--2da9</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for the &lt;a href="https://dev.to/challenges/hacktoberfest-weekend-2026-10-01"&gt;Hacktoberfest Weekend Challenge: Build for a Friend&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  What I Built
&lt;/h2&gt;

&lt;p&gt;I built &lt;strong&gt;Udhaar Khata (उधार खाता)&lt;/strong&gt; — a voice-powered, 100% local open-weights digital ledger and credit book built specifically for &lt;strong&gt;my father&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;My father manages a neighbourhood shop in India. Like millions of small business owners and community elders, managing daily customer credit (&lt;em&gt;udhaar&lt;/em&gt;) is a constant challenge. Customers regularly take essential items (rations, groceries, milk) on credit and settle their balances later. &lt;/p&gt;

&lt;p&gt;For decades, my father has tracked everything in dog-eared paper notebooks (&lt;em&gt;bahi khata&lt;/em&gt;). Whenever I suggested commercial bookkeeping apps, he found them frustrating:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Smartphone touch keyboards are awkward and slow when your hands are busy handling merchandise and customers are waiting in line.&lt;/li&gt;
&lt;li&gt;The menus are cluttered with English-first business jargon and ads.&lt;/li&gt;
&lt;li&gt;Most importantly, he hated the idea of uploading his customers' personal phone numbers and debt history to unknown third-party cloud servers.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;strong&gt;Udhaar Khata solves this completely through voice-first open-weights AI.&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
My father simply taps the microphone and speaks naturally in colloquial Hindi or Hinglish:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;em&gt;"Ramesh ne 200 udhaar liya"&lt;/em&gt; (Ramesh took ₹200 on credit)&lt;/li&gt;
&lt;li&gt;
&lt;em&gt;"Sunita ne 500 wapas kiye"&lt;/em&gt; (Sunita repaid ₹500)&lt;/li&gt;
&lt;li&gt;
&lt;em&gt;"Sharma ji ko 1200 ka ration udhaar diya"&lt;/em&gt; (Sharma ji took ₹1200 worth of ration on credit)&lt;/li&gt;
&lt;li&gt;
&lt;em&gt;"Mukesh ne 450 jama karwaye"&lt;/em&gt; (Mukesh deposited ₹450)&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The application transcribes the speech locally using &lt;strong&gt;OpenAI Whisper&lt;/strong&gt;, extracts the customer name, rupee amount, credit/debit direction, and item notes using &lt;strong&gt;Google Gemma 2 (2B)&lt;/strong&gt;, displays a clean confirmation card with audio playback, updates the customer's balance sheet, and even crafts polite, culturally respectful Hindi payment reminders with 1-click WhatsApp messaging!&lt;/p&gt;


&lt;h2&gt;
  
  
  Demo
&lt;/h2&gt;
&lt;h3&gt;
  
  
  📸 Dashboard Overview
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F5isgyjs41dzpoj07rh4u.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F5isgyjs41dzpoj07rh4u.png" alt="Udhaar Khata Dashboard" width="800" height="482"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h3&gt;
  
  
  🎥 End-to-End Walkthrough (Voice Input, Confirmation, Reminders &amp;amp; Settlements)
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ffzp24onzvud0kfr6g9ns.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ffzp24onzvud0kfr6g9ns.webp" alt="Udhaar Khata Demo Video" width="599" height="365"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Voice &amp;amp; Speech Input Hub&lt;/strong&gt;: Pulsating mic button with audio waveform animation, bilingual speech recognition, and instant sample chips.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;AI Extraction &amp;amp; Confirmation Card&lt;/strong&gt;: Displays detected customer name, amount, credit/debit toggle, and audio confirmation feedback before committing to the ledger.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Customer Directory &amp;amp; Balance Sheet&lt;/strong&gt;: Instant breakdown of &lt;em&gt;Kispar kitna baaki hai&lt;/em&gt; (Who owes what), color-coded red for &lt;em&gt;Lena hai&lt;/em&gt; (To collect) and green for &lt;em&gt;Hisaab chukta&lt;/em&gt; (Settled).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Culturally Respectful Payment Reminders (तगादा)&lt;/strong&gt;: Generates reminders in 3 distinct tones (विनम्र / Polite, मित्रतापूर्ण / Friendly, व्यावसायिक / Formal) plus custom AI drafting, with a direct 1-click &lt;strong&gt;WhatsApp Share&lt;/strong&gt; button.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;1-Click Settlement ("Hisaab Chukta")&lt;/strong&gt;: One click settles debts with confetti celebration.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;100% Offline &amp;amp; Private&lt;/strong&gt;: Zero external cloud APIs, zero subscription fees.&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  Code
&lt;/h2&gt;

&lt;p&gt;The entire source code is structured with a Python FastAPI backend and a modern React Vite frontend:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;GitHub Repository&lt;/strong&gt;: &lt;a href="https://github.com/ish1416/Udhaar-Khata" rel="noopener noreferrer"&gt;https://github.com/ish1416/Udhaar-Khata&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  How I Built It
&lt;/h2&gt;

&lt;p&gt;Udhaar Khata is built from the ground up around &lt;strong&gt;open-weights AI models running locally on consumer hardware&lt;/strong&gt;:&lt;/p&gt;
&lt;h3&gt;
  
  
  1. Information Extraction &amp;amp; Semantic Parsing (Google Gemma 2 2B)
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;We run Google's &lt;strong&gt;Gemma 2 2B&lt;/strong&gt; (&lt;code&gt;gemma2:2b&lt;/code&gt;) locally via Ollama with Metal GPU acceleration on Apple Silicon.&lt;/li&gt;
&lt;li&gt;Gemma 2 is prompted to understand colloquial Indian financial terms (&lt;em&gt;udhaar&lt;/em&gt;, &lt;em&gt;jama&lt;/em&gt;, &lt;em&gt;chukta&lt;/em&gt;, &lt;em&gt;baaki&lt;/em&gt;, &lt;em&gt;rokda&lt;/em&gt;, &lt;em&gt;saman&lt;/em&gt;) and outputs strict structured JSON containing &lt;code&gt;customer_name&lt;/code&gt;, &lt;code&gt;amount&lt;/code&gt;, &lt;code&gt;type&lt;/code&gt;, and &lt;code&gt;note&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;To guarantee 100% uptime and sub-millisecond responsiveness even under cold-start conditions, we paired Gemma 2 with a deterministic Indic-NLP bilingual rule engine.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  2. Speech-to-Text (Open-Weight OpenAI Whisper)
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Audio transcription runs through open-weight &lt;strong&gt;faster-whisper&lt;/strong&gt; (&lt;code&gt;ctranslate2&lt;/code&gt; + int8 quantization) and the browser Web Speech API, allowing my father to speak naturally in Hindi (&lt;code&gt;hi-IN&lt;/code&gt;) and Hinglish without typing a single character.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  3. Polite Hindi Reminder Generator
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;In Indian business culture, asking customers to repay credit can feel awkward or socially sensitive. &lt;/li&gt;
&lt;li&gt;Using Gemma 2 2B, the app drafts culturally nuanced payment reminders in three predefined tones (Polite, Friendly, Formal) as well as custom prompts (e.g. &lt;em&gt;"Tell them distributor payment is due tomorrow"&lt;/em&gt;), and encodes them into instant WhatsApp click-to-chat links (&lt;code&gt;https://wa.me/...&lt;/code&gt;).&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  4. Local Database &amp;amp; Privacy Architecture
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;All customer accounts, contact numbers, and transaction ledgers are stored in a local &lt;strong&gt;SQLite database&lt;/strong&gt; on my father's laptop. Not a single byte of financial data ever touches an external cloud server.&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  Why Does Open Innovation Matter?
&lt;/h2&gt;

&lt;p&gt;This project is a living example of where &lt;strong&gt;an open-weights approach worked infinitely better than closed commercial APIs&lt;/strong&gt;:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Financial Sovereignty &amp;amp; Absolute Privacy&lt;/strong&gt;: Small shopkeeper credit books contain confidential debt records, personal trust networks, and customer phone numbers. Sending this sensitive financial ledger to third-party proprietary APIs (like OpenAI or Claude) is an unnecessary privacy and trust risk. With Gemma 2 and Whisper running locally, my father's records stay 100% on his machine.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Works in Marketplaces with No Internet&lt;/strong&gt;: Indian local markets and small towns frequently experience broadband cuts and spotty mobile reception. Closed APIs fail the moment the Wi-Fi drops. By running open-weights inference locally, Udhaar Khata works seamlessly 24/7 without internet.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Zero Operating Cost (Forever ₹0)&lt;/strong&gt;: A small neighbourhood shopkeeper operating on tight margins cannot pay metered token bills or $20/month SaaS subscription fees. Open weights allow this application to run indefinitely on consumer hardware for free.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Colloquial Linguistic Freedom&lt;/strong&gt;: Open models gave us the flexibility to fine-tune system prompts for colloquial Hinglish dialects without hitting arbitrary API censorship or rigid guardrails around financial language.&lt;/li&gt;
&lt;/ol&gt;


&lt;h2&gt;
  
  
  My Agent Session
&lt;/h2&gt;

&lt;p&gt;I built this project with pair programming and browser automation. You can explore the full session transcript here:&lt;/p&gt;


&lt;div class="ltag-agent-session"&gt;
  &lt;div class="agent-session-header"&gt;
    
    &lt;span class="agent-session-tool-icon-badge" title="Gemini CLI"&gt;
&lt;/span&gt;
    &lt;span class="agent-session-title"&gt;Building Udhaar-Khata: Voice AI Digital Ledger for Father using Local Gemma 2 and Whisper&lt;/span&gt;
  &lt;/div&gt;

  &lt;div class="agent-session-scroll"&gt;

      &lt;div class="agent-session-message agent-session-user"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-user"&gt;
          You
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;I am participating in Hacktoberfest Weekend Challenge: Build for a Friend. Building Udhaar Khata for my father using local open-weight AI models (no closed APIs). He speaks in Hindi/Hinglish like 'Ramesh ne 200 udhaar liya' or 'Sunita ne 500 wapas kiye'.&lt;/p&gt;

                &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-assistant"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-assistant"&gt;
          Agent
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Architecting Udhaar-Khata with 100% local open-weights AI: Google Gemma 2 (2B) running via Ollama on Apple Silicon for information extraction and polite reminder drafting, OpenAI Whisper for local speech-to-text, and a bilingual React interface with SQLite local storage.&lt;/p&gt;

                &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-assistant"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-assistant"&gt;
          Agent
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Installed and configured Ollama with gemma2:2b locally. Verified local inference with sub-second Hindi/Hinglish transaction parsing and entity extraction.&lt;/p&gt;

                &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;

      &lt;div class="agent-session-message agent-session-assistant"&gt;
        &lt;div class="agent-session-role-badge agent-session-role-assistant"&gt;
          Agent
        &lt;/div&gt;
        &lt;div class="agent-session-content"&gt;
                &lt;div class="agent-session-text"&gt;
                  &lt;p&gt;Implemented polite payment reminder generator with multiple culturally respectful Hindi tones (Vinamra, Mitratapoorna, Vyavsayik) and 1-click WhatsApp deep integration. Tested end-to-end via browser automation.&lt;/p&gt;

                &lt;/div&gt;
        &lt;/div&gt;
      &lt;/div&gt;
  &lt;/div&gt;

  &lt;div class="agent-session-footer"&gt;
    &lt;span class="agent-session-meta"&gt;
        4 of 4 messages
    &lt;/span&gt;
  &lt;/div&gt;
&lt;/div&gt;





&lt;h2&gt;
  
  
  Prize Categories
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Best Use of Gemma&lt;/strong&gt; (Featured Category)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Overall Hacktoberfest Winner&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>devchallenge</category>
      <category>weekendchallenge</category>
      <category>hf26challenge</category>
      <category>ai</category>
    </item>
  </channel>
</rss>
