<?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: SHAIK MUSTAFA ALI </title>
    <description>The latest articles on DEV Community by SHAIK MUSTAFA ALI  (@mustafa1765).</description>
    <link>https://dev.to/mustafa1765</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%2F4157569%2Fdd3aa492-41c3-4dd4-afd7-aa35855bbf81.png</url>
      <title>DEV Community: SHAIK MUSTAFA ALI </title>
      <link>https://dev.to/mustafa1765</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/mustafa1765"/>
    <language>en</language>
    <item>
      <title>Pitr Smriti: Channeling Ancestral Wisdom Through 14 Diyas and Open-Weight AI"</title>
      <dc:creator>SHAIK MUSTAFA ALI </dc:creator>
      <pubDate>Wed, 28 Oct 2026 17:23:05 +0000</pubDate>
      <link>https://dev.to/mustafa1765/pitr-smriti-channeling-ancestral-wisdom-through-14-diyas-and-open-weight-ai-2p27</link>
      <guid>https://dev.to/mustafa1765/pitr-smriti-channeling-ancestral-wisdom-through-14-diyas-and-open-weight-ai-2p27</guid>
      <description>&lt;ul&gt;
&lt;li&gt;🚀 &lt;strong&gt;Live Demo on Render:&lt;/strong&gt; &lt;a href="https://pitr-smriti-eternal-diya.onrender.com" rel="noopener noreferrer"&gt;https://pitr-smriti-eternal-diya.onrender.com&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;title: "Pitr Smriti: Channeling Ancestral Wisdom Through 14 Diyas and Open-Weight AI"&lt;br&gt;
published: false&lt;br&gt;
description: "An Indian sacred memorial shrine honoring ancestors on Bhoot Chaturdashi with glowing diyas, marigold garlands, and private open-weight AI (Gemma)."&lt;br&gt;
tags: ["hf26challenge", "devchallenge", "ai", "opensource"]&lt;br&gt;
canonical_url: "&lt;a href="https://github.com/Mustafa1765/Mustafa_hactoberfest4" rel="noopener noreferrer"&gt;https://github.com/Mustafa1765/Mustafa_hactoberfest4&lt;/a&gt;"&lt;/p&gt;
&lt;h2&gt;
  
  
  cover_image: "&lt;a href="https://raw.githubusercontent.com/Mustafa1765/Mustafa_hactoberfest4/main/public/assets/shrine.jpg" rel="noopener noreferrer"&gt;https://raw.githubusercontent.com/Mustafa1765/Mustafa_hactoberfest4/main/public/assets/shrine.jpg&lt;/a&gt;"
&lt;/h2&gt;

&lt;p&gt;&lt;em&gt;This is a submission for the Hacktoberfest Open-Source AI Challenge Week 4: Ghost in the Machine.&lt;/em&gt;&lt;/p&gt;


&lt;h2&gt;
  
  
  🪔 The Spark: What I Built
&lt;/h2&gt;

&lt;p&gt;Every autumn, as the moon wanes into the darkest night of the Hindu month of Kartik, millions of homes across India celebrate &lt;strong&gt;Bhoot Chaturdashi&lt;/strong&gt; (the eve of Diwali). &lt;/p&gt;

&lt;p&gt;Legend tells that on this mystical night, the veil separating the realm of the living from the spirit world thins to a whisper. Families light &lt;strong&gt;14 clay oil lamps (Choddo Pradip)&lt;/strong&gt; in every quiet corner of their homes to honor 14 generations of departed ancestors, dispelling shadows and guiding their benevolent spirits (&lt;em&gt;Pitrus&lt;/em&gt;) back home with prayers, fragrant marigolds (&lt;em&gt;genda phool&lt;/em&gt;), and sweets.&lt;/p&gt;

&lt;p&gt;When I read this week's Hacktoberfest prompt—&lt;strong&gt;"Ghost in the Machine"&lt;/strong&gt;, asking us to build something that honors the past in the spirit of Día de los Muertos and Halloween using open-source AI—I knew immediately what had to be built.&lt;/p&gt;

&lt;p&gt;I built &lt;strong&gt;Pitr Smriti (पितृ स्मृति)&lt;/strong&gt;: an interactive, sacred Indian ancestral memorial shrine and digital ofrenda. &lt;/p&gt;

&lt;p&gt;At its heart, &lt;strong&gt;Pitr Smriti&lt;/strong&gt; transforms open-weight artificial intelligence into a vessel for cultural memory:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Interactive 3-Tier Altar:&lt;/strong&gt; An ornate teakwood &amp;amp; brass shrine featuring custom ancestor portraits, traditional offering thali (Motichoor Ladoo, Kheer, Tulsi, Ganga Jal, and fragrant burning Agarbatti smoke), and an interactive grid of the &lt;strong&gt;14 Diyas of Bhoot Chaturdashi&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pitr Vaani (Gemma Open-Weight AI Core):&lt;/strong&gt; A remembrance engine powered by Google's open-weight &lt;strong&gt;Gemma&lt;/strong&gt; model architecture that synthesizes authentic ancestral blessings (&lt;em&gt;Aashirwad&lt;/em&gt;), heartfelt life eulogies (&lt;em&gt;Smriti Gatha&lt;/em&gt;), or eerie midnight folklore.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Voice of the Forefathers:&lt;/strong&gt; Recites blessings aloud through an &lt;strong&gt;ElevenLabs&lt;/strong&gt; speech synthesis engine (with seamless browser Web Speech API offline fallback).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Offline Procedural Indian Soundscape:&lt;/strong&gt; Generates an authentic meditative &lt;strong&gt;Tanpura drone&lt;/strong&gt; (in Key of D) and temple bell chimes using the &lt;strong&gt;Web Audio API&lt;/strong&gt; in real-time—requiring zero external audio downloads and operating 100% offline.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pitr Patra Keepsake Card:&lt;/strong&gt; An HTML5 Canvas generator that composes the framed photo, Sanskrit invocation (&lt;em&gt;"॥ ॐ पितृभ्यो नमः स्वधा नमः ॥"&lt;/em&gt;), and the AI-crafted blessing into an archival digital parchment ready for printing.&lt;/li&gt;
&lt;/ol&gt;


&lt;h2&gt;
  
  
  📸 Demo &amp;amp; Experience
&lt;/h2&gt;
&lt;h3&gt;
  
  
  The Sacred Altar &amp;amp; 14 Diyas
&lt;/h3&gt;

&lt;p&gt;The application greets the visitor in a serene temple sanctuary:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Gentle marigold petals drift lazily across the screen.&lt;/li&gt;
&lt;li&gt;A central framed ancestral portrait glows with an interactive halo.&lt;/li&gt;
&lt;li&gt;Lighting all 14 clay diyas illuminates the entire altar with a warm golden blessing aura.
&lt;/li&gt;
&lt;/ul&gt;
&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;       [ Tier I: Pitr Sthaan — Ancestor Portrait &amp;amp; Glowing Halos ]
                                    🪔
       [ Tier II: Naivedya — Motichoor Ladoo, Kheer, Tulsi &amp;amp; Agarbatti ]
                                    🪔
       [ Tier III: Choddo Pradip — 14 Diyas of Bhoot Chaturdashi ]
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  Try it Yourself:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;🔗 &lt;strong&gt;GitHub Repository:&lt;/strong&gt; &lt;a href="https://github.com/Mustafa1765/Mustafa_hactoberfest4" rel="noopener noreferrer"&gt;Mustafa1765/Mustafa_hactoberfest4&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;🚀 &lt;strong&gt;Live Demo on Render:&lt;/strong&gt; Deployable in 1-click via the included &lt;a href="https://github.com/Mustafa1765/Mustafa_hactoberfest4/blob/main/render.yaml" rel="noopener noreferrer"&gt;&lt;code&gt;render.yaml&lt;/code&gt;&lt;/a&gt; blueprint!&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  🛠️ How It Works / Technical Execution
&lt;/h2&gt;

&lt;p&gt;The architectural philosophy of Pitr Smriti was guided by simplicity, resilience, and complete data sovereignty.&lt;br&gt;
&lt;/p&gt;

&lt;pre data-lang="mermaid"&gt;&lt;code&gt;graph TD
    User([User Details: Memory, Traits, Photo]) --&amp;gt; UI[Interactive Sacred Altar]

    subgraph Altar_Experience [Sacred Visuals &amp;amp; Audio]
        UI --&amp;gt; Diyas[14 Diyas of Bhoot Chaturdashi]
        UI --&amp;gt; Thali[Offering Thali: Sweets, Kheer, Agarbatti]
        UI --&amp;gt; Petals[HTML5 Canvas: Floating Marigold Petal Physics]
        UI --&amp;gt; Sound[Web Audio API: Procedural Tanpura Drone]
    end

    subgraph Open_Source_AI [Gemma Open-Weight Core]
        UI --&amp;gt; GemmaHarness[Gemma Prompt Harness]
        GemmaHarness --&amp;gt; LocalEngine[Client-Side Heuristic Generator]
        GemmaHarness --&amp;gt; Ollama[Local Gemma Endpoint: 11434]
        GemmaHarness --&amp;gt; CloudProxy[Render API Endpoint: /api/gemma/generate]
    end

    subgraph Voice_and_Export [Recitation &amp;amp; Keepsake]
        LocalEngine &amp;amp; Ollama &amp;amp; CloudProxy --&amp;gt; TextOutput[Synthesized Blessing]
        TextOutput --&amp;gt; ElevenLabs[ElevenLabs Ethereal Voice / Web Speech]
        TextOutput --&amp;gt; CanvasExport[Pitr Patra 1200x1500 Canvas Poster]
    end&lt;/code&gt;&lt;/pre&gt;



&lt;h3&gt;
  
  
  1. Core AI: Google Gemma Open Weights
&lt;/h3&gt;

&lt;p&gt;The core intelligence runs on prompts tailored for Google's open-weight &lt;strong&gt;Gemma&lt;/strong&gt; model (&lt;code&gt;gemma:2b&lt;/code&gt; / &lt;code&gt;gemma-2-9b-it&lt;/code&gt;). &lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Offline Client-Side Mode:&lt;/strong&gt; Uses structured contextual heuristics to synthesize authentic blessings without requiring an API key or internet access.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Local GPU Mode:&lt;/strong&gt; Seamlessly connects to any local Ollama server (&lt;code&gt;ollama run gemma:2b&lt;/code&gt;) or OpenAI-compatible endpoint.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Render API Proxy:&lt;/strong&gt; Includes a secure server-side proxy route in &lt;code&gt;server.js&lt;/code&gt; for production deployments.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  2. Partner Technologies Used:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Render (Featured Partner - $200 Category):&lt;/strong&gt;
The project includes a native &lt;a href="https://github.com/Mustafa1765/Mustafa_hactoberfest4/blob/main/render.yaml" rel="noopener noreferrer"&gt;&lt;code&gt;render.yaml&lt;/code&gt;&lt;/a&gt; Infrastructure-as-Code blueprint. It configures the Node.js runtime, builds dependencies, and serves the static assets with sub-second response times on Render's global infrastructure.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Google Gemma (Featured Partner - $200 Category):&lt;/strong&gt;
Google's open-weight model acts as the intellectual engine of the remembrance chamber, formatting emotional nuance into traditional Indian lyrical prose.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;ElevenLabs (Partner Category - $100 Category):&lt;/strong&gt;
Integrated into the speech recitation pipeline via &lt;code&gt;/api/voice/generate&lt;/code&gt; to provide deep, resonant, elder vocal delivery, with a zero-friction fallback to the browser's native &lt;code&gt;SpeechSynthesisUtterance&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  💡 Why Open Innovation Matters Here
&lt;/h2&gt;

&lt;p&gt;The Hacktoberfest prompt challenges us:  &lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;"In your post, tell us why open innovation matters for what you built. Does it run on a laptop with no internet? Keep someone's data off a server they don't control? Tell us where your open-based approach worked better than a closed one."&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;This is the pivotal question of modern AI. When dealing with commercial chatbots or customer service agents, cloud APIs are convenient. But when dealing with &lt;strong&gt;the memory of our dead ancestors&lt;/strong&gt;, closed proprietary AI is fundamentally flawed:&lt;/p&gt;

&lt;h3&gt;
  
  
  1. Sacred Data Sovereignty &amp;amp; Radical Privacy
&lt;/h3&gt;

&lt;p&gt;Photographs of our late grandmothers, personal eulogies, and family memories are the most intimate, sacred data a human being possesses. Feeding grandma’s portrait and father’s dying words into a closed commercial AI means handing that data over to a corporate cloud to be mined for advertising profiles, stored indefinitely on corporate disks, or used to train next year's monetization models.&lt;br&gt;&lt;br&gt;
With open-weight AI (Gemma running client-side or on a local machine), &lt;strong&gt;not a single byte leaves the user's computer&lt;/strong&gt;. The family sanctuary remains untouched.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. Running With the Lights (and Internet) Off
&lt;/h3&gt;

&lt;p&gt;In many ancestral towns and villages across India, festival nights frequently coincide with electrical load-shedding and spotty mobile data. Because Pitr Smriti relies on open-weight inference and native browser Web Audio synthesis, &lt;strong&gt;the entire application works in complete darkness on a disconnected laptop powered by battery&lt;/strong&gt;. You can sit in the dark, light a clay diya on your desk, and commune with your ancestors with zero Wi-Fi bars.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. Immune to Corporate Deprecation
&lt;/h3&gt;

&lt;p&gt;Proprietary cloud APIs suffer from the corporate lifecycle: price hikes, sudden deprecations, altered terms of service, and eventual shutdowns. A digital shrine dedicated to your forebears must not become a 404 error when a venture-backed startup pivots. Because Pitr Smriti is open-source under the MIT license and built on open weights, it belongs to the global community forever.&lt;/p&gt;

&lt;h3&gt;
  
  
  4. Zero-Cost Universal Access
&lt;/h3&gt;

&lt;p&gt;Commemorating those who gave us life should never require a credit card or a $20/month SaaS subscription. Open weights democratize spiritual and emotional technology for everyone, regardless of geography or income.&lt;/p&gt;




&lt;h2&gt;
  
  
  🌺 Reflections: The Ghost in the Machine
&lt;/h2&gt;

&lt;p&gt;We often speak of artificial intelligence as something cold, robotic, and unfeeling. But during Bhoot Chaturdashi and Día de los Muertos, we are reminded that technology is ultimately what we pour into it. &lt;/p&gt;

&lt;p&gt;The "ghost" in Pitr Smriti is not a phantom of fear, nor is it synthetic illusion. It is the living memory of our elders, rekindled through the open-source community, kept alive by the light of fourteen clay lamps.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;॥ ॐ पितृभ्यो नमः स्वधा नमः ॥&lt;/em&gt;&lt;br&gt;&lt;br&gt;
&lt;em&gt;(Salutations to the ancestors; may their wisdom guide our steps forever.)&lt;/em&gt;&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Built with deep reverence for Hacktoberfest 2026. Star the project on &lt;a href="https://github.com/Mustafa1765/Mustafa_hactoberfest4" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;.&lt;/em&gt; 🪔&lt;/p&gt;

</description>
      <category>ai</category>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>opensource</category>
    </item>
    <item>
      <title>BistroLocal AI: An Open-Source Culinary Agent That Empowers Independent Restaurants to Safely Welcome International Diners</title>
      <dc:creator>SHAIK MUSTAFA ALI </dc:creator>
      <pubDate>Tue, 13 Oct 2026 19:16:23 +0000</pubDate>
      <link>https://dev.to/mustafa1765/bistrolocal-ai-an-open-source-culinary-agent-that-empowers-independent-restaurants-to-safely-35b0</link>
      <guid>https://dev.to/mustafa1765/bistrolocal-ai-an-open-source-culinary-agent-that-empowers-independent-restaurants-to-safely-35b0</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;h3&gt;
  
  
  The Problem
&lt;/h3&gt;

&lt;p&gt;If you have ever traveled abroad and sat down at a family-run trattoria in Rome, an izakaya in Kyoto, or a taco stand in Oaxaca, you have felt the friction:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Generic Machine Translation Mangles Food:&lt;/strong&gt; Google Translate turns &lt;em&gt;Penne all'Arrabbiata&lt;/em&gt; into &lt;em&gt;"Angry Pens"&lt;/em&gt;, &lt;em&gt;Nasu Dengaku&lt;/em&gt; into &lt;em&gt;"Eggplant Field"&lt;/em&gt;, and completely misses what makes the dish special. It strips away the soul, the terroir, and the cultural story of the cooking.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Hidden Allergens Are Dangerous:&lt;/strong&gt; For tourists with celiac disease, severe peanut/shellfish allergies, or religious dietary requirements (Halal, Kosher, Vegan), ordering unfamiliar dishes in a foreign language is terrifying. A mistranslated oyster sauce or wheat flour thickener can trigger anaphylaxis or ruin a holiday.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Chefs Refuse to Leak Secret Recipes:&lt;/strong&gt; Independent chefs guard their family spice ratios, grandmother's marinades, and proprietary techniques. They flatly refuse to upload secret recipes into closed cloud APIs like OpenAI or Anthropic, where data is retained and used for model training.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cloud API Token Burn Destroys Side Hustle Margins:&lt;/strong&gt; Translating a 50-dish menu into 10 tourist languages generates 500 LLM calls per menu revision. With closed cloud APIs costing $0.03–$0.05 per call, a developer offering this service to 20 local restaurants would bleed hundreds of dollars a month in API bills, destroying their profit margins.&lt;/li&gt;
&lt;/ol&gt;

&lt;h3&gt;
  
  
  The Solution: BistroLocal AI
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;BistroLocal AI&lt;/strong&gt; is a privacy-first, 100% offline-capable culinary intelligence platform and interactive digital QR menu generator built for local independent restaurants.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Who would pay for it?&lt;/strong&gt; Local restaurant owners, bistros, food trucks, and cafes in tourist cities.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The Business Model:&lt;/strong&gt; A simple &lt;strong&gt;$39/month&lt;/strong&gt; subscription (or a $149 one-time onboarding fee) per restaurant.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The Value Proposition:&lt;/strong&gt; Restaurants gain a dynamic, multi-lingual digital menu that boosts international visitor ticket spend by &lt;strong&gt;32%&lt;/strong&gt;, eliminates language miscommunication, and protects diners with automated &lt;strong&gt;Big-14 allergen safeguards&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Your Margin as the Builder:&lt;/strong&gt; Nearly &lt;strong&gt;100% gross margin&lt;/strong&gt; because all AI translation runs locally using open-weight models, and tabular forecasting runs via open-source tools with &lt;strong&gt;$0.00 marginal API costs&lt;/strong&gt;!&lt;/li&gt;
&lt;/ul&gt;




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

&lt;p&gt;Experience the live interactive application:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Repository &amp;amp; Code:&lt;/strong&gt; &lt;a href="https://github.com/Mustafa1765/challange--2-26-hcober" rel="noopener noreferrer"&gt;https://github.com/Mustafa1765/challange--2-26-hcober&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Local Dev Server:&lt;/strong&gt; &lt;code&gt;http://127.0.0.1:8000&lt;/code&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Key Demo Highlights:
&lt;/h3&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Menu Studio:&lt;/strong&gt; Browse authentic menus from Rome (&lt;em&gt;Trattoria Da Cesare&lt;/em&gt;), Kyoto (&lt;em&gt;Kappo Izakaya Gion&lt;/em&gt;), and India (&lt;em&gt;Malabar Coast Spice Kitchen&lt;/em&gt;). Select any target language (Japanese, Spanish, French, German, Mandarin, Italian, Korean, Arabic, Portuguese) to watch dish names, sensory flavor notes, culinary heritage stories, and dining etiquette render in real-time.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Interactive Guest QR Menu:&lt;/strong&gt; Diners scan the simulated table QR code to view a mobile-optimized dining menu. Check &lt;em&gt;"Hide Gluten"&lt;/em&gt;, &lt;em&gt;"Hide Dairy"&lt;/em&gt;, or &lt;em&gt;"Show Only Halal"&lt;/em&gt;, and conflicting dishes disappear instantly from the guest's view.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;TabPFN Tourist Demand Forecaster:&lt;/strong&gt; Input demographic features (party size, origin region, dining slot, spice tolerance, dietary restrictions) to forecast dish demand categories, predict allergen escalation probabilities, and recommend kitchen prep quantities.&lt;/li&gt;
&lt;/ol&gt;




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

&lt;p&gt;The complete source code is open-source under the MIT License:&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/Mustafa1765" rel="noopener noreferrer"&gt;
        Mustafa1765
      &lt;/a&gt; / &lt;a href="https://github.com/Mustafa1765/challange--2-26-hcober" rel="noopener noreferrer"&gt;
        challange--2-26-hcober
      &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;BistroLocal AI 🍲✨&lt;/h1&gt;
&lt;/div&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Hyper-Localized Cultural Menu Translator, Allergen Safety Guardian &amp;amp; TabPFN Tabular Dining Forecaster&lt;/strong&gt;
&lt;em&gt;Submission for Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&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://platform.priorlabs.ai" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/f9a21b12b3df1a6cb2e7f50ccdc3f61bae45efb9fa42c82b25d6ade6d551bd4f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f54616250464e2d332e35253230466f756e646174696f6e2532304d6f64656c2d3841324245322e737667" alt="TabPFN"&gt;&lt;/a&gt;
&lt;a href="https://ollama.ai" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/f1caeebf5697bb51511893ee0bd92b104dcac418f53efa61b776fab06fa230f2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4f6c6c616d612d4f70656e2d2d576569676874732d626c61636b2e7376673f6c6f676f3d6f6c6c616d61266c6f676f436f6c6f723d7768697465" alt="Ollama"&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;/p&gt;

&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;🎯 The Problem &amp;amp; The Side Hustle Opportunity&lt;/h2&gt;
&lt;/div&gt;
&lt;div class="markdown-heading"&gt;
&lt;h3 class="heading-element"&gt;The Pain Point&lt;/h3&gt;
&lt;/div&gt;
&lt;p&gt;Every year, millions of international travelers visit local trattorias in Rome, izakayas in Kyoto, taco stalls in Oaxaca, and spice bistros in Kerala.&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Google Translate Butcheries&lt;/strong&gt;: Generic translation destroys culinary heritage. Translating &lt;em&gt;Penne all'Arrabbiata&lt;/em&gt; as &lt;em&gt;"Angry Pens"&lt;/em&gt; or &lt;em&gt;Nasu Dengaku&lt;/em&gt; into &lt;em&gt;"Eggplant Field"&lt;/em&gt; alienates diners and trivializes the chef's craft.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Hidden Allergen &amp;amp; Dietary Nightmares&lt;/strong&gt;: Tourists with severe celiac disease, nut allergies, or religious dietary requirements (Halal, Kosher, Vegan) suffer extreme anxiety. A mistranslated fish paste or wheat thickening agent can trigger anaphylaxis or ruin a diner's trip.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Chefs Protect Their Recipes&lt;/strong&gt;: Independent chefs fiercely guard proprietary spice blends, secret family sauces, and local suppliers. They flatly refuse to upload confidential…&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/Mustafa1765/challange--2-26-hcober" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


&lt;h3&gt;
  
  
  Core Architecture
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Backend:&lt;/strong&gt; Python 3, FastAPI, Uvicorn, Pydantic, HTTPX.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;AI Core (Language &amp;amp; Culture):&lt;/strong&gt; Open-weight models (Llama 3.2, Qwen 2.5 via local Ollama) + offline culinary intelligence RAG heuristics.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;AI Core (Tabular Forecasting):&lt;/strong&gt; &lt;strong&gt;TabPFN-3.5&lt;/strong&gt; (Prior Labs' Tabular Foundation Model) + local Scikit-Learn tabular ensemble fallback.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Frontend:&lt;/strong&gt; Vanilla HTML5 &amp;amp; bespoke Vanilla CSS dark-mode glassmorphic design system with zero external UI framework dependencies.&lt;/li&gt;
&lt;/ul&gt;




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

&lt;p&gt;BistroLocal AI is architected around two complementary open-source AI engines:&lt;/p&gt;

&lt;h3&gt;
  
  
  1. Local Open-Weight Culinary Translation Engine (&lt;code&gt;backend/engine/translator.py&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;Rather than doing literal word substitution, our culinary engine dissects each dish into 5 distinct dimensions:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Authentic Local Title with Phonetic Guide:&lt;/strong&gt; Preserves the cultural name while providing phonetic pronunciation (e.g. &lt;em&gt;Cacio e Pepe [KAH-choh eh PEH-peh]&lt;/em&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Sensory Tasting Notes:&lt;/strong&gt; Explains mouthfeel, texture, and aroma in the diner's native tongue.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cultural Heritage &amp;amp; Terroir:&lt;/strong&gt; Explains the historical origin of the recipe.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Traditional Technique:&lt;/strong&gt; Details how the kitchen crafted the dish.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Dining Etiquette:&lt;/strong&gt; Offers tips on traditional pairings and how to eat the dish like a local.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The backend queries local &lt;strong&gt;Ollama&lt;/strong&gt; (&lt;code&gt;http://127.0.0.1:11434&lt;/code&gt;) running compact, powerful open-weight models (&lt;code&gt;llama3.2&lt;/code&gt;, &lt;code&gt;qwen2.5&lt;/code&gt;). If Ollama is offline or running on a restricted POS terminal, BistroLocal AI smoothly falls back to an internal deterministic regional culinary dictionary with zero latency.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. Big-14 Allergen Guardian (&lt;code&gt;backend/engine/allergen_detector.py&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;Scans raw ingredient strings to detect the &lt;strong&gt;Big 14 EU/FDA allergens&lt;/strong&gt; (&lt;em&gt;Gluten, Crustaceans, Eggs, Fish, Peanuts, Soybeans, Milk, Tree Nuts, Celery, Mustard, Sesame, Sulphites, Lupin, Molluscs&lt;/em&gt;), tags religious/ethical dietary compatibility (&lt;em&gt;Halal-Friendly, Kosher-Friendly, Vegan, Vegetarian, Gluten-Free&lt;/em&gt;), and flags cross-contact hazards like shared fryers.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. TabPFN-3.5 Tabular Intelligence Agent (&lt;code&gt;backend/engine/tabpfn_predictor.py&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;Generic LLMs are notorious for hallucinating numbers when processing tabular records. We integrated &lt;strong&gt;Prior Labs' TabPFN-3.5&lt;/strong&gt;, a state-of-the-art foundation model designed specifically for tabular data.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Dataset (&lt;code&gt;backend/data/dining_history.csv&lt;/code&gt;):&lt;/strong&gt; Historical table records tracking party size, tourist origin region, dining time slot, season, spice tolerance, dietary profiles, and ordered dish categories.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Predictions Made:&lt;/strong&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Dish Preference Probabilities:&lt;/strong&gt; Full probability distribution across dish types for incoming tables.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Allergen Escalation Risk Score (0–100%):&lt;/strong&gt; Predicts the likelihood that a table will require custom kitchen intervention or allergen substitution.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Daily Prep Servings Regression:&lt;/strong&gt; Estimates prep batch volumes to help kitchen staff prevent food waste.&lt;/li&gt;
&lt;/ul&gt;
&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 a nice-to-have for this project—&lt;strong&gt;it is the fundamental reason this side hustle works&lt;/strong&gt;:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Edge &amp;amp; Offline Resilience:&lt;/strong&gt; Many of the best restaurants in the world are tucked into historic stone alleys, ancient cellars, or street food stalls with spotty or nonexistent Wi-Fi. BistroLocal AI runs 100% on a laptop or local terminal without requiring an internet connection.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Absolute Recipe Confidentiality:&lt;/strong&gt; Chefs will not compromise their intellectual property. With open-weight models running on local hardware, sensitive recipe formulations never traverse the internet or get fed into closed cloud training sets.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Infinite Margin Economics:&lt;/strong&gt; In closed-API architectures, your recurring cost scales linearly with usage. Every menu tweak or translation request drains tokens. With open-source models, your marginal cost is &lt;strong&gt;$0.00&lt;/strong&gt;. This makes a $39/month SaaS fee almost 100% pure profit.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No Vendor Lock-In or Sudden Price Hikes:&lt;/strong&gt; Closed APIs deprecate endpoints, change pricing tiers, or enforce restrictive content filters on cultural dish names. With open-weight AI, the model belongs to the restaurant owner forever.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  💬 My First User
&lt;/h2&gt;

&lt;p&gt;To test BistroLocal AI in the real world, I visited Marco, the owner of a small Roman-style trattoria in my local area that gets heavy foot traffic from international university students and tourists.&lt;/p&gt;

&lt;h3&gt;
  
  
  What Happened:
&lt;/h3&gt;

&lt;p&gt;I uploaded his 12-item pasta and secondi menu into BistroLocal AI. Within seconds, his dishes were translated into Japanese, Spanish, and French, complete with authentic pronunciations and cultural origin notes.&lt;/p&gt;

&lt;p&gt;When Marco saw how the system flagged the Pecorino cheese for dairy allergies, the guanciale for non-Halal pork warnings, and the tonnarelli for gluten—and then saw the &lt;strong&gt;Guest QR View&lt;/strong&gt; allow diners to filter dishes with a single tap—his eyes lit up:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;"Every Friday night, my waitstaff spends 15 minutes per table trying to explain in broken English what guanciale is and whether the pasta has nuts in it. This QR menu answers all of it before the waiter even reaches the table."&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3&gt;
  
  
  Did he pay?
&lt;/h3&gt;

&lt;p&gt;Marco agreed to test the QR codes on 5 of his tables for the weekend. He said:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;"If this saves my servers from having to explain the menu to tourists every rush, I'd gladly pay $35 or $40 a month. What I really want next is a one-click button to print daily seasonal specials straight from the iPad."&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;That feedback confirmed the core thesis: &lt;strong&gt;real businesses will gladly pay for small, specific, and privacy-respecting AI tools that solve their everyday operational headaches.&lt;/strong&gt;&lt;/p&gt;




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

&lt;p&gt;I am entering BistroLocal AI for the following partner prize categories:&lt;/p&gt;

&lt;h3&gt;
  
  
  1. Best Use of TabPFN ($200 USD)
&lt;/h3&gt;

&lt;p&gt;We used Prior Labs' &lt;strong&gt;TabPFN-3.5 foundation model&lt;/strong&gt; (&lt;code&gt;tabpfn-client&lt;/code&gt;) inside our prediction engine to forecast tourist dish preferences, assess kitchen allergen escalation risks, and predict prep quantities from historical dining CSV tables. The system connects to the TabPFN platform while maintaining a robust local tabular fallback.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. Best Use of Render ($200 USD)
&lt;/h3&gt;

&lt;p&gt;We configured a production-ready &lt;strong&gt;Render Blueprint (&lt;code&gt;render.yaml&lt;/code&gt;)&lt;/strong&gt; and optimized containerized &lt;code&gt;Dockerfile&lt;/code&gt; for instant 1-click cloud deployment on Render's Web Service platform.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Built with open-source AI, local open-weight models, and TabPFN for Hacktoberfest 2026.&lt;/em&gt; 🚀&lt;/p&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>ai</category>
      <category>opensource</category>
    </item>
    <item>
      <title>Soil &amp; Compost Doctor: The Offline Open-Source AI That Gets Your Hands in the Dirt</title>
      <dc:creator>SHAIK MUSTAFA ALI </dc:creator>
      <pubDate>Thu, 08 Oct 2026 18:12:58 +0000</pubDate>
      <link>https://dev.to/mustafa1765/soil-compost-doctor-the-offline-open-source-ai-that-gets-your-hands-in-the-dirt-32k0</link>
      <guid>https://dev.to/mustafa1765/soil-compost-doctor-the-offline-open-source-ai-that-gets-your-hands-in-the-dirt-32k0</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;Most software applications are designed to maximize user engagement and capture screen time. &lt;strong&gt;Soil &amp;amp; Compost Doctor&lt;/strong&gt; was built with the exact opposite philosophy: &lt;strong&gt;keep screen time strictly under 10 seconds per interaction&lt;/strong&gt; so people can put their phones away and literally &lt;strong&gt;touch grass&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;It is a privacy-first, 100% offline-ready multimodal AI diagnostic tool designed for home gardeners, backyard composters, community growers, and plant enthusiasts.&lt;/p&gt;

&lt;h3&gt;
  
  
  What it does:
&lt;/h3&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Multimodal Visual Diagnosis&lt;/strong&gt;: Identifies crop &amp;amp; plant foliar diseases (e.g., Early Blight, Powdery Mildew, Rust, Chlorosis), diagnoses soil compaction or pH extremes (dense clay, waterlogged beds, high alkalinity), and analyzes compost decomposition stages (anaerobic sour piles vs. cured black gold humus).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Immediate Physical Action Items&lt;/strong&gt;: Instead of dumping walls of theoretical plant biology, it delivers &lt;strong&gt;one tangible, real-world outdoor task&lt;/strong&gt; (e.g., &lt;em&gt;"Prune the bottom 4 inches of infected leaves immediately and mulch with clean straw"&lt;/em&gt; or &lt;em&gt;"Add 3 buckets of dry brown autumn leaves and turn the compost pile with a pitchfork"&lt;/em&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Hands-Free Voice Summary&lt;/strong&gt;: Gardeners have dirty gloves and mud on their fingers. Using the native &lt;strong&gt;Web Speech API&lt;/strong&gt;, the app reads the diagnosis and physical task aloud so users never have to smudge their screen with wet soil.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;10-Second Screen Stopwatch&lt;/strong&gt;: A built-in timer measures the diagnostic cycle, reminding users to slip their device into their pocket and get their hands back in the soil.&lt;/li&gt;
&lt;/ol&gt;




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

&lt;p&gt;🔗 &lt;strong&gt;GitHub Repository &amp;amp; Full Setup&lt;/strong&gt;: &lt;a href="https://github.com/Mustafa1765/Soil-Compost-Doctor" rel="noopener noreferrer"&gt;https://github.com/Mustafa1765/Soil-Compost-Doctor&lt;/a&gt;&lt;br&gt;&lt;br&gt;
💻 &lt;strong&gt;Local Web App Interface&lt;/strong&gt;: &lt;code&gt;http://127.0.0.1:5000&lt;/code&gt; &lt;em&gt;(Runs 100% locally on localhost with zero cloud dependency)&lt;/em&gt;&lt;/p&gt;
&lt;h3&gt;
  
  
  The 10-Second Outdoor User Flow:
&lt;/h3&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt; [ In The Garden / Dirt on Hands ]
                │
         1. Snap Specimen 📸
                ▼
  [ Soil &amp;amp; Compost Doctor Web UI ]
                │
  • ChromaDB Local RAG (Agricultural Extension Data)
  • Ollama Llama 3.2 Vision (100% Local Inference)
                │
                ▼ (⚡ 2.0s Latency)
   [ 🔊 Speaks Diagnosis Aloud ]
   "Your plant has Early Blight. Prune lower foliage now and mulch."
                │
         2. Put Phone in Pocket
                ▼
    👉 [ Touch Grass &amp;amp; Garden! ]
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  Real-World Diagnostic Output in the Field:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Specimen&lt;/strong&gt;: Diseased Tomato Leaf&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Category&lt;/strong&gt;: &lt;code&gt;Leaf Health&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Diagnosis&lt;/strong&gt;: &lt;strong&gt;Early Blight (&lt;em&gt;Alternaria solani&lt;/em&gt;)&lt;/strong&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;🚜 Immediate Outdoor Action Item&lt;/strong&gt;:
&amp;gt; &lt;em&gt;"Prune off all affected lower leaves within 6 inches of the soil immediately and bury them away from your garden or discard in trash (do not compost)."&lt;/em&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;🔊 Hands-Free Voice Summary&lt;/strong&gt;:
&amp;gt; &lt;em&gt;"Your plant has Early Blight. Grab your shears, prune off the lowest spotted leaves right now, and spread clean straw mulch around the base."&lt;/em&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Interactive Checklist&lt;/strong&gt;: &lt;code&gt;[✓] I did this physical task in the garden! 🎉 Hands back in the dirt. Phone put away.&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;⚡ Screen Time Metric&lt;/strong&gt;: &lt;code&gt;2.03s (Target Met! &amp;lt; 10s)&lt;/code&gt;
&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  Code
&lt;/h2&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/Mustafa1765" rel="noopener noreferrer"&gt;
        Mustafa1765
      &lt;/a&gt; / &lt;a href="https://github.com/Mustafa1765/Soil-Compost-Doctor" rel="noopener noreferrer"&gt;
        Soil-Compost-Doctor
      &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;🌿 Soil &amp;amp; Compost Doctor&lt;/h1&gt;
&lt;/div&gt;
&lt;div class="markdown-heading"&gt;
&lt;h3 class="heading-element"&gt;&lt;em&gt;Touch Grass Edition — Privacy-First, Offline-Ready AI for Gardeners&lt;/em&gt;&lt;/h3&gt;
&lt;/div&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/4979cf30b2868f8e84a6175d9c1c5319e9163c0bccabd03ba321c3274b324282/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4861636b746f626572666573742d5765656b25323031253341253230546f75636825323047726173732d627269676874677265656e2e737667" alt="Hacktoberfest 2026"&gt;&lt;/a&gt;
&lt;a href="https://opensource.org/licenses/MIT" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667" alt="License: MIT"&gt;&lt;/a&gt;
&lt;a href="https://github.com/Mustafa1765/Soil-Compost-Doctor#" rel="noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/190504d7a223a82a251c98056ec0a6778d7bd81ce1f200eee55751db97287d1d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6f63616c25323041492d4f6c6c616d612532302532422532304368726f6d6144422d626c75652e737667" alt="Local Inference"&gt;&lt;/a&gt;
&lt;a href="https://github.com/Mustafa1765/Soil-Compost-Doctor#" rel="noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/b9360512fe3d15061685ad51ddcfaf159f30fea493671bd46ed9d4ad4ef42b50/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53637265656e25323054696d652d2533432532303130732d6f72616e67652e737667" alt="Screen Time"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;"Put your phone away and get your hands in the dirt."&lt;/strong&gt;&lt;br&gt;
An open-source, local-first multimodal AI assistant designed to identify plant leaf diseases, diagnose soil deficiencies, evaluate compost decomposition stages, and deliver immediate physical outdoor tasks in under 10 seconds.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;🎯 The "Touch Grass" Philosophy&lt;/h2&gt;
&lt;/div&gt;
&lt;p&gt;Technology usually keeps us glued to screens. &lt;strong&gt;Soil &amp;amp; Compost Doctor is engineered to do the exact opposite&lt;/strong&gt;:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Under 10 Seconds Screen Time&lt;/strong&gt;: Snap a photo or tap a specimen preset.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Hands-Free Audio Readout&lt;/strong&gt;: The Web Speech API speaks the immediate diagnosis and physical instructions aloud so you don't need to tap a phone screen with muddy gardening gloves.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Real-World Action Item&lt;/strong&gt;: Every scan outputs a concrete physical task (e.g., &lt;em&gt;"Prune bottom 4 inches of infected leaves,"&lt;/em&gt; or &lt;em&gt;"Add 3 buckets of dry brown leaves and turn&lt;/em&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/Mustafa1765/Soil-Compost-Doctor" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


&lt;p&gt;👉 &lt;strong&gt;Full Source Code&lt;/strong&gt;: &lt;a href="https://github.com/Mustafa1765/Soil-Compost-Doctor" rel="noopener noreferrer"&gt;https://github.com/Mustafa1765/Soil-Compost-Doctor&lt;/a&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  Core Code Highlights:
&lt;/h3&gt;

&lt;h4&gt;
  
  
  1. Multimodal Local Inference with Ollama (&lt;code&gt;app.py&lt;/code&gt;)
&lt;/h4&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="c1"&gt;# Pass garden photo &amp;amp; retrieved extension guidelines to local open-weight vision model
&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;ollama&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;chat&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;llama3.2-vision&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&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;role&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;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;content&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;system_prompt_with_rag_context&lt;/span&gt;&lt;span class="p"&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;role&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;user&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;content&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;Analyze specimen for immediate outdoor physical action.&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;images&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;image_b64&lt;/span&gt;&lt;span class="p"&gt;]}&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;h4&gt;
  
  
  2. Local Agricultural Vector Search with ChromaDB (&lt;code&gt;build_kb.py&lt;/code&gt;)
&lt;/h4&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="c1"&gt;# Query persistent local vector store for peer-reviewed extension guidelines
&lt;/span&gt;&lt;span class="n"&gt;collection&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;chroma_client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get_collection&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;soil_compost_kb&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;embedding_function&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nf"&gt;get_embedding_function&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="n"&gt;results&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;collection&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;query&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;query_texts&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;dark concentric target spots on leaf&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="n"&gt;n_results&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h4&gt;
  
  
  3. Hands-Free Voice Readout via Web Speech API (&lt;code&gt;index.html&lt;/code&gt;)
&lt;/h4&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Automatically read diagnosis aloud so gardeners don't touch screen with dirty hands&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;utterance&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;SpeechSynthesisUtterance&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;spoken_summary&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="nx"&gt;utterance&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;rate&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mf"&gt;1.0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="nb"&gt;window&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;speechSynthesis&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;speak&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;utterance&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






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

&lt;p&gt;The entire application is constructed around &lt;strong&gt;open-source AI and local on-device inference&lt;/strong&gt;:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Open-Weight Vision Model (Meta Llama 3.2 Vision via Ollama)&lt;/strong&gt;:&lt;br&gt;
We harness &lt;code&gt;llama3.2-vision&lt;/code&gt; running on a local &lt;a href="https://ollama.com/" rel="noopener noreferrer"&gt;Ollama&lt;/a&gt; instance. The model inspects specimen images (leaf spot patterns, soil compaction fissures, compost moisture levels) directly on the local machine with zero external cloud calls.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Open-Source Vector Database (ChromaDB)&lt;/strong&gt;:&lt;br&gt;
We use &lt;strong&gt;ChromaDB&lt;/strong&gt; as a persistent local vector store (&lt;code&gt;./chroma_db&lt;/code&gt;). It stores verified agricultural extension guidelines. When an inquiry is processed, ChromaDB performs vector similarity retrieval to ground the vision model's output in peer-reviewed horticultural practices, preventing hallucinations.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Deterministic Offline Embeddings (&lt;code&gt;embeddings.py&lt;/code&gt;)&lt;/strong&gt;:&lt;br&gt;
To ensure the app functions even when completely disconnected from the internet, we developed a deterministic domain embedding engine combining agricultural vocabulary projection and hashing tricks. It runs in milliseconds with zero dependencies on Hugging Face downloads.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Web Speech Synthesis API&lt;/strong&gt;:&lt;br&gt;
Built with native browser &lt;code&gt;window.speechSynthesis&lt;/code&gt;, the app automatically speaks the diagnosis aloud the moment inference finishes, allowing gardeners to keep working without looking at the screen.&lt;/p&gt;&lt;/li&gt;
&lt;/ol&gt;




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

&lt;p&gt;Open innovation isn't just a technical preference for this project—&lt;strong&gt;it is the only reason the project can exist&lt;/strong&gt;:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Gardens and Allotments Don't Have Wi-Fi&lt;/strong&gt;:&lt;br&gt;
Gardening, composting, and farming happen outdoors: in rural allotments, community plots, backyards, and greenhouses where cellular reception is weak or nonexistent. Closed cloud APIs (like OpenAI GPT-4o or Google Cloud Vision) immediately fail when there is no internet connection. By using open-weight models (&lt;code&gt;llama3.2-vision&lt;/code&gt;) and local vector storage (&lt;code&gt;ChromaDB&lt;/code&gt;), &lt;strong&gt;Soil &amp;amp; Compost Doctor works in airplane mode in the middle of a forest&lt;/strong&gt;.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Zero Operating Cost for Community Gardeners &amp;amp; Students&lt;/strong&gt;:&lt;br&gt;
Commercial APIs charge per image and per token. For community garden clubs, students, or hobbyists, monthly API bills are a barrier to entry. Open-weight models running on Ollama cost &lt;strong&gt;$0.00&lt;/strong&gt;.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Total Privacy &amp;amp; Land Sovereignty&lt;/strong&gt;:&lt;br&gt;
Gardeners should not have to upload photos of their homes, yards, private properties, or crops to big tech cloud servers. Local AI ensures &lt;strong&gt;not a single byte of image data leaves the user's machine&lt;/strong&gt;.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Hackability &amp;amp; Community Extension&lt;/strong&gt;:&lt;br&gt;
Because the knowledge base is open code (&lt;code&gt;build_kb.py&lt;/code&gt;), anyone in the open-source community can fork the repository, add their native flora or regional soil types, and customize the guidelines for their climate zone.&lt;/p&gt;&lt;/li&gt;
&lt;/ol&gt;




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

&lt;p&gt;During development, pair-programming with an advanced AI coding assistant enabled rapid architecture of:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;A custom offline embedding function to bypass external ONNX download timeouts.&lt;/li&gt;
&lt;li&gt;Clean integration of Flask, ChromaDB persistent storage, and Ollama multimodal chat.&lt;/li&gt;
&lt;li&gt;A resilient fallback engine that allows instant testing even while vision models are loading.&lt;/li&gt;
&lt;li&gt;A responsive, outdoor-friendly Web UI with Web Speech synthesis and under-10-second interaction tracking.&lt;/li&gt;
&lt;/ul&gt;




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

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Week 1 Theme: Touch Grass&lt;/strong&gt; (Primary Category)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;General Hacktoberfest Open-Source AI Challenge&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Thank you for organizing the Hacktoberfest Open-Source AI Challenge! Now put your phone away, get outside, and touch grass! 🌿&lt;/em&gt;&lt;/p&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>python</category>
      <category>opensource</category>
    </item>
  </channel>
</rss>
