<?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: Balabhadra</title>
    <description>The latest articles on DEV Community by Balabhadra (@balabhadra520).</description>
    <link>https://dev.to/balabhadra520</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%2F4103041%2F54a24fc0-0b1e-45e0-98b6-219c55ce19ff.jpg</url>
      <title>DEV Community: Balabhadra</title>
      <link>https://dev.to/balabhadra520</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/balabhadra520"/>
    <language>en</language>
    <item>
      <title>PhantomTrace | Hacktoberfest-Week4</title>
      <dc:creator>Balabhadra</dc:creator>
      <pubDate>Fri, 30 Oct 2026 22:10:09 +0000</pubDate>
      <link>https://dev.to/balabhadra520/phantomtrace-the-offline-ai-forensic-detective-investigating-ghosts-in-system-logs-1kn4</link>
      <guid>https://dev.to/balabhadra520/phantomtrace-the-offline-ai-forensic-detective-investigating-ghosts-in-system-logs-1kn4</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;h2&gt;
  
  
  What I Built
&lt;/h2&gt;

&lt;p&gt;Every machine leaves a trace. Some tell a story.&lt;/p&gt;

&lt;p&gt;When a computer or cloud server is compromised, attackers don't just disappear—they leave behind faint digital apparitions: dozens of failed authentication attempts in the dead of night, an unusual &lt;code&gt;sudo&lt;/code&gt; session opened by a low-privileged account, a sudden backdoor user added to &lt;code&gt;/etc/passwd&lt;/code&gt;, and an attempt to erase audit logs. &lt;/p&gt;

&lt;p&gt;To seasoned SOC tier-3 analysts, these logs tell an obvious story. But for junior developers, sysadmins, and small open-source teams without dedicated security personnel, raw logs are intimidating walls of cryptic text. Existing SIEM tools will throw alerts, but reconstructing &lt;strong&gt;what happened, when it happened, and how the adversary navigated the system&lt;/strong&gt; is agonizingly difficult.&lt;/p&gt;

&lt;h3&gt;
  
  
  Enter PhantomTrace 👻
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;PhantomTrace&lt;/strong&gt; is an offline, privacy-first AI digital forensics investigator that resurrects suspicious system activity and conducts an autonomous digital autopsy.&lt;/p&gt;

&lt;p&gt;Instead of another chatbot that writes Halloween ghost stories, &lt;strong&gt;PhantomTrace&lt;/strong&gt; interprets the &lt;em&gt;"Ghost in the Machine"&lt;/em&gt; theme through real-world cybersecurity:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;The "Ghosts":&lt;/strong&gt; The hidden, lingering footprints left behind by adversaries in authentication and event logs.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The "Medium":&lt;/strong&gt; A deterministic rule-based threat engine grounded in the &lt;strong&gt;MITRE ATT&amp;amp;CK&lt;/strong&gt; matrix that extracts and links attack sequences without hallucinating.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The "Detective":&lt;/strong&gt; An open-weight local AI model (running via &lt;strong&gt;Ollama&lt;/strong&gt; or its built-in offline reasoning engine) that interrogates the evidence, reconstructs the breach lifecycle, and writes official forensic incident reports.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The Haunted Terminal Mode:&lt;/strong&gt; A retro CRT phosphor-green terminal where the forensic investigator narrates the intruder’s steps like a digital ghost speaking from the system bus.&lt;/li&gt;
&lt;/ol&gt;




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

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;GitHub Repository:&lt;/strong&gt; &lt;a href="https://github.com/balabhadra3141/Hacktoberfest-Week4" rel="noopener noreferrer"&gt;https://github.com/balabhadra3141/Hacktoberfest-Week4&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Interactive SOC Dashboard:&lt;/strong&gt; &lt;code&gt;http://localhost:5173&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;1-Click Demo Scenarios:&lt;/strong&gt; Built-in attack datasets ready to test in 10 seconds:

&lt;ul&gt;
&lt;li&gt;🐧 &lt;strong&gt;Linux Server Breach:&lt;/strong&gt; Multi-IP SSH brute force -&amp;gt; root credential acquisition -&amp;gt; privilege escalation -&amp;gt; rogue account creation (&lt;code&gt;ghost_backdoor&lt;/code&gt;) -&amp;gt; crontab persistence.&lt;/li&gt;
&lt;li&gt;🪟 &lt;strong&gt;Windows Domain Lateral Movement:&lt;/strong&gt; Event ID 4625 brute force -&amp;gt; 4624 successful logon -&amp;gt; 4672 &lt;code&gt;SeDebugPrivilege&lt;/code&gt; elevation -&amp;gt; &lt;code&gt;PsExec&lt;/code&gt; remote execution -&amp;gt; &lt;code&gt;wevtutil&lt;/code&gt; log clearing.&lt;/li&gt;
&lt;li&gt;🌐 &lt;strong&gt;Web Server RCE:&lt;/strong&gt; Directory traversal + SQL injection -&amp;gt; PHP web shell upload -&amp;gt; reverse shell payload execution.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Key Screens &amp;amp; Features in Action
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;SOC Overview Console:&lt;/strong&gt; Real-time Ghost Threat Index gauge (0–100), alert severity distribution, and MITRE tactic breakdown charts.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Ghost Timeline:&lt;/strong&gt; Interactive chronological attack reconstruction tracing the adversary's actions with color-coded severity nodes and raw log drill-downs.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;AI Chat Investigator:&lt;/strong&gt; Grounded interactive Q&amp;amp;A where you can ask &lt;em&gt;"Was this a brute force attack?"&lt;/em&gt;, &lt;em&gt;"Which events connect in the kill chain?"&lt;/em&gt;, or &lt;em&gt;"Provide remediation steps"&lt;/em&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Incident Report Generator:&lt;/strong&gt; 1-click download of an official, publication-ready &lt;strong&gt;Incident Response PDF&lt;/strong&gt; (generated locally via ReportLab) and structured JSON for SIEM ingestion.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Haunted Terminal:&lt;/strong&gt; Retro cyber-terminal that types out the ghostly autopsy stream line by line.&lt;/li&gt;
&lt;/ul&gt;




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

&lt;p&gt;The entire codebase is open-source under the MIT License:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Hacktoberfest-Week4/
├── backend/
│   ├── main.py               # FastAPI backend with CORS, streaming, &amp;amp; REST endpoints
│   ├── detector.py           # Deterministic threat engine (MITRE ATT&amp;amp;CK mapping &amp;amp; scoring)
│   ├── ollama_client.py      # Ollama local LLM connector + Zero-fail offline DFIR engine
│   ├── report_generator.py   # Publication-ready PDF (ReportLab) &amp;amp; JSON export
│   ├── samples.py            # Pre-loaded multi-stage attack scenarios
│   └── requirements.txt      # Pure Python dependencies (FastAPI, uvicorn, reportlab)
├── frontend/
│   ├── src/
│   │   ├── components/
│   │   │   ├── Navbar.tsx            # Case status, Ghost Score pill, &amp;amp; engine indicator
│   │   │   ├── SOCDashboard.tsx      # Metrics, Recharts attack vectors, &amp;amp; alert feed
│   │   │   ├── EvidenceScanner.tsx   # 1-click scenario loader, file upload, &amp;amp; raw log paste
│   │   │   ├── GhostTimeline.tsx     # Chronological attack graph with MITRE tactic tags
│   │   │   ├── AIChatInvestigator.tsx# Grounded forensic investigator chat with prompt chips
│   │   │   ├── ForensicReport.tsx    # Official DFIR report, IOC table, &amp;amp; 1-click PDF export
│   │   │   └── HauntedTerminal.tsx   # Retro CRT cyber terminal with real-time digital autopsy
│   │   ├── types.ts                  # TypeScript interfaces for all data structures
│   │   ├── App.tsx                   # Central state &amp;amp; scenario orchestrator
│   │   └── index.css                 # Cyber-obsidian &amp;amp; spectral emerald theme
│   ├── package.json
│   └── vite.config.ts
├── samples/                          # Standalone raw sample logs
├── run.bat                           # 1-Click Windows launcher
└── README.md                         # Architecture, installation, &amp;amp; judge guide
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;You can clone and run it with one command:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git clone https://github.com/balabhadra3141/Hacktoberfest-Week4.git
&lt;span class="nb"&gt;cd &lt;/span&gt;Hacktoberfest-Week4
.&lt;span class="se"&gt;\r&lt;/span&gt;un.bat   &lt;span class="c"&gt;# Or `cd backend &amp;amp;&amp;amp; uvicorn main:app` and `cd frontend &amp;amp;&amp;amp; npm run dev`&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;PhantomTrace combines a deterministic rule pipeline with local open-weight AI inference:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;       System Logs (Linux / Windows / Web)
                      │
                      ▼
        ┌───────────────────────────┐
        │   Log Normalization &amp;amp;     │
        │   Deterministic Rules     │ ◄── Regex Threat Engine (MITRE T1110, T1548, etc.)
        └─────────────┬─────────────┘
                      │
        ┌─────────────▼─────────────┐
        │  Ghost Timeline Rebuilder │ ◄── Chronological Attack Sequences
        └─────────────┬─────────────┘
                      │
         ┌────────────┴────────────┐
         ▼                         ▼
┌──────────────────┐      ┌─────────────────────────┐
│ Local LLM        │      │ Grounded Fallback       │
│ (Ollama/Qwen2.5) │  OR  │ Offline Forensic Agent  │ (100% Free / Zero Setup)
└────────┬─────────┘      └────────────┬────────────┘
         │                             │
         └─────────────┬───────────────┘
                       │
       ┌───────────────┼───────────────┐
       ▼               ▼               ▼
┌──────────────┐ ┌─────────────┐ ┌───────────────┐
│ SOC Console  │ │ AI Chat Q&amp;amp;A │ │ PDF / JSON    │
│ &amp;amp; Terminal   │ │ Investigator│ │ Report Export │
└──────────────┘ └─────────────┘ └───────────────┘
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  1. Deterministic Grounding (Preventing AI Hallucinations)
&lt;/h3&gt;

&lt;p&gt;A major risk in AI cybersecurity is hallucination—an LLM imagining an attack or inventing a fake IP address. &lt;br&gt;
PhantomTrace solves this through a two-stage pipeline:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Stage 1 (Deterministic Core):&lt;/strong&gt; &lt;code&gt;detector.py&lt;/code&gt; uses high-speed regex pattern matching to parse Linux syslog/auth.log, Windows EVTX-exported events, and Web server access logs. It identifies confirmed threat indicators (SSH brute force, &lt;code&gt;sudo&lt;/code&gt; elevation, rogue accounts) and tags them with official &lt;strong&gt;MITRE ATT&amp;amp;CK&lt;/strong&gt; technique IDs (&lt;code&gt;T1110.001&lt;/code&gt;, &lt;code&gt;T1548.003&lt;/code&gt;, &lt;code&gt;T1136.001&lt;/code&gt;, &lt;code&gt;T1070.001&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Stage 2 (Narrative &amp;amp; Correlation):&lt;/strong&gt; The local AI model receives &lt;em&gt;only&lt;/em&gt; verified facts and timeline nodes as grounding context. The AI's job is synthesis, kill-chain correlation, and threat explanation—not guessing.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  2. Local Open-Weight Inference (Ollama + Qwen2.5 / Llama 3.2)
&lt;/h3&gt;

&lt;p&gt;PhantomTrace connects directly to a locally hosted &lt;strong&gt;Ollama&lt;/strong&gt; instance (&lt;code&gt;http://127.0.0.1:11434&lt;/code&gt;) using open-weight models such as &lt;code&gt;qwen2.5:3b&lt;/code&gt; or &lt;code&gt;llama3.2&lt;/code&gt;. &lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;No cloud API keys required.&lt;/li&gt;
&lt;li&gt;Zero network requests leave your machine during analysis.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Zero-Fail Fallback Engine:&lt;/strong&gt; To ensure the project works flawlessly for any judge or developer who doesn't have Ollama installed, the backend includes an embedded deterministic AI reasoning engine. If Ollama is offline, PhantomTrace switches automatically and seamlessly to this offline agent.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  3. Frontend &amp;amp; Visualizations
&lt;/h3&gt;

&lt;p&gt;Built with &lt;strong&gt;React 19&lt;/strong&gt;, &lt;strong&gt;TypeScript&lt;/strong&gt;, &lt;strong&gt;Tailwind CSS&lt;/strong&gt;, and &lt;strong&gt;Recharts&lt;/strong&gt;:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Obsidian &amp;amp; Spectral Emerald Palette:&lt;/strong&gt; A sleek Security Operations Center (SOC) theme.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Recharts Integration:&lt;/strong&gt; Visual breakdown of MITRE ATT&amp;amp;CK tactics and alert severity distributions.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;ReportLab Engine:&lt;/strong&gt; Generates official DFIR incident reports in PDF format with executive summaries, IOC tables, and remediation playbooks.&lt;/li&gt;
&lt;/ul&gt;


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

&lt;p&gt;In digital forensics and cybersecurity, &lt;strong&gt;open innovation is not just a preference—it is a non-negotiable architectural requirement.&lt;/strong&gt;&lt;/p&gt;
&lt;h3&gt;
  
  
  1. Absolute Privacy &amp;amp; Air-Gapped Operation
&lt;/h3&gt;

&lt;p&gt;System logs contain some of the most sensitive data an organization possesses: private IP architectures, internal hostnames, user credentials, failed passwords, and command histories. &lt;br&gt;
Sending raw production authentication logs to a proprietary, cloud-hosted closed API (like OpenAI or Anthropic) violates compliance standards (GDPR, HIPAA, SOC 2) and actively creates a new data-exfiltration risk. &lt;br&gt;
With &lt;strong&gt;open-weight models and Ollama&lt;/strong&gt;, PhantomTrace operates completely offline. You can disconnect your ethernet cable, turn off Wi-Fi, and run an in-depth forensic investigation on an air-gapped laptop in a data center.&lt;/p&gt;
&lt;h3&gt;
  
  
  2. Auditability &amp;amp; Grounded Transparency
&lt;/h3&gt;

&lt;p&gt;Closed AI APIs are black boxes that can change, deprecate models, or alter safety guardrails overnight. In forensic investigations where evidence might be presented in court or an insurance audit, you need predictable, auditable, deterministic inference. Open-source models can be versioned, inspected, fine-tuned, and verified locally.&lt;/p&gt;
&lt;h3&gt;
  
  
  3. Zero Cost &amp;amp; Universal Accessibility
&lt;/h3&gt;

&lt;p&gt;Small startups, non-profits, independent developers, and open-source maintainers cannot afford enterprise SIEM subscriptions that charge thousands of dollars per gigabyte of ingested logs. PhantomTrace proves that open-source AI and deterministic engineering can give anyone an enterprise-grade digital forensic investigator for &lt;strong&gt;$0&lt;/strong&gt;.&lt;/p&gt;


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

&lt;p&gt;This entire application—from backend threat rules and Ollama integration to the React dashboard, timeline graph, and PDF report generator—was developed through an agentic pair-programming session with &lt;strong&gt;Antigravity&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;The workflow:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Architectural design focusing on deterministic threat detection + local LLM grounding.&lt;/li&gt;
&lt;li&gt;Rapid implementation of the FastAPI backend, ReportLab PDF generator, and synthetic incident logs.&lt;/li&gt;
&lt;li&gt;Building the React + TypeScript frontend with Tailwind CSS and Recharts.&lt;/li&gt;
&lt;li&gt;Testing live inference and verifying complete offline resilience.&lt;/li&gt;
&lt;/ol&gt;


&lt;h2&gt;
  
  
  The Spirit of It
&lt;/h2&gt;

&lt;p&gt;The moment this project truly came alive was when we tested the &lt;strong&gt;Haunted Terminal Mode&lt;/strong&gt; on the Linux Server Breach dataset:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;╔══════════════════════════════════════════════════════════════════════╗
║ PHANTOMTRACE FORENSIC KERNEL v1.0.0-HACKTOBERFEST                   ║
║ Every machine leaves a trace. Some tell a story.                    ║
╚══════════════════════════════════════════════════════════════════════╝
[*] [PHANTOMTRACE] Initializing Spectral Memory Extraction...
[*] Probing kernel ring buffer and forensic event journals...
[*] Captured 14 spirit traces across system bus.
[!] DANGER: Detected 5 paranormal security deviations!
[!] Spectral Origin Located: Foreign IP entity `198.51.100.42` manifesting on port 22.
[&amp;gt;] Trace #1: SSH Brute Force Attack (5 attempts) [T1110.001]
    ↳ Whisper: Detected 5 failed authentication attempts originating from IP 198.51.100.42.
[💀] THE GHOST BREACHED THE GATE: Authentication barrier collapsed!
[💀] GHOST ELEVATION: The entity possessed root UID 0 permissions!
[💀] PHANTOM RESIDUE: Adversary left a rogue soul in the user registry!
[*] Forensic timeline sealed. Digital autopsy complete.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Watching cryptic log lines transform into a coherent, gripping narrative—not as fictional fantasy, but as an accurate, MITRE-mapped autopsy of a real cyber incursion—made it clear: &lt;strong&gt;AI doesn't just need to generate text; it can give eyes and ears to systems that were previously silent.&lt;/strong&gt;&lt;/p&gt;




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

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Open Innovation Track:&lt;/strong&gt; Privacy-first, offline digital forensics powered by open-weight AI models.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cybersecurity &amp;amp; AI Agents Track:&lt;/strong&gt; Autonomous DFIR agent with deterministic grounding, MITRE ATT&amp;amp;CK correlation, and automated incident response reporting.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Ghost in the Machine (Halloween Theme):&lt;/strong&gt; Uncovering the ghost traces left in machine memory and narrating the breach via the Haunted Terminal.&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Built with ❤️ for Hacktoberfest 2026. Every machine leaves a trace. Some tell a story.&lt;/em&gt; 👻&lt;/p&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>cybersecurity</category>
      <category>ai</category>
    </item>
    <item>
      <title>UdhaarOS | Hacktoberfest-Week2</title>
      <dc:creator>Balabhadra</dc:creator>
      <pubDate>Sun, 18 Oct 2026 16:20:36 +0000</pubDate>
      <link>https://dev.to/balabhadra520/udhaaros-hacktoberfest-week2-4hc8</link>
      <guid>https://dev.to/balabhadra520/udhaaros-hacktoberfest-week2-4hc8</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;In India and emerging markets, over &lt;strong&gt;30 million Kirana stores, corner pharmacies, neighborhood grocers, and side-hustle merchants&lt;/strong&gt; sell on informal credit (&lt;em&gt;Udhaar&lt;/em&gt;). Selling on credit builds deep community trust and loyalty — but managing it is a daily nightmare:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Messy Paper Diaries &amp;amp; Lost Records:&lt;/strong&gt; Merchants jot down daily dues on loose paper slips or torn notebooks (&lt;em&gt;Khatabook&lt;/em&gt;). Entries get misplaced, forgotten, or disputed by customers.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Awkward &amp;amp; Delayed Collections:&lt;/strong&gt; Asking neighbors and regular patrons for money feels uncomfortable. As a result, reminders are either delayed for months or worded too aggressively, damaging customer relationships.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cash-Flow Blindspots:&lt;/strong&gt; Store owners rarely know their exact aging breakdown (how much money is overdue past 30, 60, or 90 days), leading to bad debts and inventory stockouts.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Data Privacy Fears:&lt;/strong&gt; Small merchants distrust proprietary cloud platforms that harvest customer phone numbers, analyze sales data for competitive lending, or lock books behind subscription paywalls.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;strong&gt;UdhaarOS&lt;/strong&gt; is a privacy-first, open-source credit ledger and payment intelligence system designed specifically for neighborhood retail and side-hustle entrepreneurs. It pairs a &lt;strong&gt;deterministic financial accounting ledger&lt;/strong&gt; with &lt;strong&gt;local, open-source AI&lt;/strong&gt; to digitize messy notes and accelerate debt recovery with zero privacy trade-offs.&lt;/p&gt;

&lt;h3&gt;
  
  
  Key Capabilities
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;⚡ &lt;strong&gt;AI Smart Khatabook Digitizer:&lt;/strong&gt; Converts messy text notes, voice transcripts, and Hinglish messages (e.g. &lt;em&gt;"Ramesh ji 450 udhaar diya 2 packet aata"&lt;/em&gt;, &lt;em&gt;"Sunil paid 1200 via gpay jama"&lt;/em&gt;, &lt;em&gt;"Vikram ne 250 diye via phonepe"&lt;/em&gt;) into structured ledger entries.&lt;/li&gt;
&lt;li&gt;🛡️ &lt;strong&gt;Two-Phase Human-in-the-Loop Review:&lt;/strong&gt; AI never blindly modifies financial ledgers. Extracted entries are presented in a review table with match confidence and duplicate alerts. Merchants can edit amounts or directions before posting, and new customer profiles are provisioned automatically.&lt;/li&gt;
&lt;li&gt;💬 &lt;strong&gt;Culturally Tailored Payment Reminders:&lt;/strong&gt; Crafts polite, firm, or urgent WhatsApp and SMS reminders in &lt;strong&gt;Hindi / Hinglish&lt;/strong&gt;, &lt;strong&gt;English&lt;/strong&gt;, or &lt;strong&gt;Regional&lt;/strong&gt; languages with pre-filled UPI payment links (&lt;code&gt;wa.me&lt;/code&gt;) for one-click settlement.&lt;/li&gt;
&lt;li&gt;📖 &lt;strong&gt;GAAP-Grade Financial Ledger:&lt;/strong&gt; Full double-entry-inspired ledger tracking Credits (&lt;em&gt;Udhaar&lt;/em&gt;) and Payments (&lt;em&gt;Jama&lt;/em&gt;). All currency is computed in &lt;strong&gt;Paise&lt;/strong&gt; (integers) to prevent floating-point rounding errors.&lt;/li&gt;
&lt;li&gt;🔄 &lt;strong&gt;Audit-Compliant Reversals:&lt;/strong&gt; Transactions are never deleted. Non-destructive reversal entries preserve complete auditability with documented reasons.&lt;/li&gt;
&lt;li&gt;📊 &lt;strong&gt;Delinquency Aging Analytics:&lt;/strong&gt; Categorizes dues into &lt;em&gt;0–15 Days (Current)&lt;/em&gt;, &lt;em&gt;16–30 Days (Due Soon)&lt;/em&gt;, &lt;em&gt;31–60 Days (Overdue)&lt;/em&gt;, and &lt;em&gt;60+ Days (Critical)&lt;/em&gt; with visual 30-day debt trend charts.&lt;/li&gt;
&lt;li&gt;🔒 &lt;strong&gt;100% On-Device &amp;amp; Offline Resilient:&lt;/strong&gt; Integrates local Ollama LLMs with an instant deterministic rule-based fallback parser (&lt;code&gt;rule-parser.service.ts&lt;/code&gt;). Zero financial or customer debt data ever leaves the local machine.&lt;/li&gt;
&lt;/ul&gt;




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

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Live GitHub Repository:&lt;/strong&gt; &lt;a href="https://github.com/balabhadra3141/Hacktoberfest-Week2" rel="noopener noreferrer"&gt;https://github.com/balabhadra3141/Hacktoberfest-Week2&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cover Image:&lt;/strong&gt; &lt;code&gt;cover.jpg&lt;/code&gt; (included in repository root and &lt;code&gt;client/public/cover.jpg&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Local Interactive App:&lt;/strong&gt; Runs at &lt;code&gt;http://localhost:5173&lt;/code&gt; with backend API at &lt;code&gt;http://localhost:3001&lt;/code&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Running the Project Locally
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# 1. Clone the repository&lt;/span&gt;
git clone https://github.com/balabhadra3141/Hacktoberfest-Week2.git
&lt;span class="nb"&gt;cd &lt;/span&gt;Hacktoberfest-Week2

&lt;span class="c"&gt;# 2. Setup and run Backend&lt;/span&gt;
&lt;span class="nb"&gt;cd &lt;/span&gt;server
npm &lt;span class="nb"&gt;install
&lt;/span&gt;npx prisma db push
npx tsx prisma/seed.ts
npm run dev

&lt;span class="c"&gt;# 3. Setup and run Frontend (in a separate terminal)&lt;/span&gt;
&lt;span class="nb"&gt;cd&lt;/span&gt; ../client
npm &lt;span class="nb"&gt;install
&lt;/span&gt;npm run dev
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Visit &lt;code&gt;http://localhost:5173&lt;/code&gt; in your browser. The application is pre-seeded with a realistic Kirana store dataset (8 customers, 25+ posted transactions, overdue debts, and active limits) ready for immediate demonstration.&lt;/p&gt;




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

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Repository:&lt;/strong&gt; &lt;a href="https://github.com/balabhadra3141/Hacktoberfest-Week2" rel="noopener noreferrer"&gt;https://github.com/balabhadra3141/Hacktoberfest-Week2&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;License:&lt;/strong&gt; &lt;a href="https://github.com/balabhadra3141/Hacktoberfest-Week2/blob/main/README.md#license" rel="noopener noreferrer"&gt;MIT License&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Architecture Overview
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;┌────────────────────────────────────────────────────────┐
│                   UdhaarOS Frontend                    │
│      Vite + React 19 + TypeScript + TailwindCSS        │
│   (Dashboard, Khata, Smart Import, WhatsApp Reminders) │
└───────────────────────────┬────────────────────────────┘
                            │ REST API (JSON)
┌───────────────────────────▼────────────────────────────┐
│                   UdhaarOS Backend                     │
│               Node.js + Express + TypeScript           │
│      Zod Validation · Financial Ledger Service         │
└─────────────┬────────────────────────────┬─────────────┘
              │                            │
   Prisma ORM + SQLite             Dual-Path AI Engine
 (Audit Trails &amp;amp; Reversals)   (Ollama LLM + Rule Parser)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Frontend:&lt;/strong&gt; React 19, TypeScript, Vite, TailwindCSS, TanStack React Query, Recharts, Lucide Icons, React Hot Toast.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Backend:&lt;/strong&gt; Node.js, Express, TypeScript, Prisma ORM, SQLite, Zod validation schemas, Dayjs.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Accounting Architecture:&lt;/strong&gt; Paise precision (1 INR = 100 Paise), running ledger balances, non-destructive reversals with audit events.&lt;/li&gt;
&lt;/ul&gt;




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

&lt;h3&gt;
  
  
  1. Dual-Path Open-Source AI Architecture
&lt;/h3&gt;

&lt;p&gt;UdhaarOS is designed around open-source AI with zero external dependencies:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Dual-path extraction engine in server/src/services/ai.service.ts&lt;/span&gt;
&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;type&lt;/span&gt; &lt;span class="nx"&gt;ExtractionEngine&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;LLM&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;RULES&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Local Open-Weight LLMs (Ollama):&lt;/strong&gt; &lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Uses local inference with open-weight models (default &lt;strong&gt;&lt;code&gt;llama3&lt;/code&gt;&lt;/strong&gt;, also tested with &lt;code&gt;qwen2.5:3b&lt;/code&gt; and &lt;code&gt;llama3.2&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;Uses strict JSON output schemas to extract structured transaction objects: &lt;code&gt;customer_name&lt;/code&gt;, &lt;code&gt;type&lt;/code&gt; (&lt;code&gt;CREDIT&lt;/code&gt; vs &lt;code&gt;PAYMENT&lt;/code&gt;), &lt;code&gt;amount_paise&lt;/code&gt;, &lt;code&gt;date&lt;/code&gt;, &lt;code&gt;description&lt;/code&gt;, and &lt;code&gt;confidence&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Runtime Model Switching:&lt;/strong&gt; Merchants can inspect all installed Ollama models and switch the active model at runtime from &lt;strong&gt;Store Settings → AI Engine Diagnostics&lt;/strong&gt;, persisted directly in the database.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Deterministic Offline Fallback (&lt;code&gt;rule-parser.service.ts&lt;/code&gt;):&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Small shops cannot afford downtime if an LLM is offline or busy. &lt;/li&gt;
&lt;li&gt;We engineered a specialized regex/NLP parser tuned to Hindi, Hinglish, and Indian merchant shorthand (&lt;em&gt;"udhaar"&lt;/em&gt;, &lt;em&gt;"jama"&lt;/em&gt;, &lt;em&gt;"diya"&lt;/em&gt;, &lt;em&gt;"gpay"&lt;/em&gt;, &lt;em&gt;"ne diye"&lt;/em&gt;, with automatic unit exclusions like &lt;em&gt;kg&lt;/em&gt;, &lt;em&gt;packet&lt;/em&gt;, &lt;em&gt;ltr&lt;/em&gt;).&lt;/li&gt;
&lt;li&gt;Runs with sub-millisecond zero latency, ensuring the &lt;strong&gt;AI Smart Khatabook&lt;/strong&gt; works 100% offline without any model running.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;

&lt;h3&gt;
  
  
  2. Two-Phase Human-in-the-Loop Review
&lt;/h3&gt;

&lt;p&gt;AI should assist merchants, never blindly execute accounting entries:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Extraction Phase:&lt;/strong&gt; The merchant pastes unorganized text or clicks sample presets.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Review &amp;amp; Audit Phase:&lt;/strong&gt; Entries are mapped against the customer khata directory with confidence scores. The merchant can review, edit names, amounts, or directions, and batch-confirm with one click.&lt;/li&gt;
&lt;/ol&gt;




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

&lt;p&gt;Small business accounting is one of the most sensitive areas in commerce. Closed-source, cloud-dependent AI poses distinct hazards for local merchants:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Financial Data Sovereignty:&lt;/strong&gt; A neighborhood store’s debtor list reveals personal relationships, creditworthiness, and family purchasing power. Sending this information to proprietary cloud APIs risks corporate data mining, targeted ads, or predatory lending. Open-source AI keeps 100% of the data on the merchant's device.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Zero Recurring SaaS Costs:&lt;/strong&gt; Micro-merchants operating on 3–8% margins cannot afford monthly SaaS subscription fees or token-based API charges. Open-source open-weight models run locally for free indefinitely.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Resilience to Poor Connectivity:&lt;/strong&gt; Wholesale markets and rural retail hubs often experience intermittent internet. A closed API fails the moment connectivity drops; open-source local inference and deterministic heuristics ensure zero downtime.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Community Adaptation:&lt;/strong&gt; Open innovation allows developers to adapt models to regional languages (Tamil, Marathi, Bengali, Odia, Gujarati) and local trade terminologies without waiting for a proprietary API provider to support their dialect.&lt;/li&gt;
&lt;/ol&gt;




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

&lt;p&gt;This project was built from concept to production through an end-to-end agentic pair-programming workflow:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Domain Modeling &amp;amp; Precision Accounting:&lt;/strong&gt; Designed integer Paise schemas, double-entry ledger mechanics, and non-destructive reversal workflows.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Dual-Path AI Engineering:&lt;/strong&gt; Implemented structured Ollama local LLM integration alongside the conservative offline Hinglish rule parser.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Rapid UI/UX Iteration:&lt;/strong&gt; Crafted a responsive desktop &amp;amp; mobile experience with TailwindCSS, Recharts data visualization, and cultural design touches.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Automated Browser Subagent Testing:&lt;/strong&gt; Ran full browser subagent sessions verifying end-to-end user journeys (recording available in project artifacts).&lt;/li&gt;
&lt;/ul&gt;




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

&lt;p&gt;To test UdhaarOS against real-world scenarios, I walked through the workflow with a neighborhood Kirana store owner (&lt;em&gt;Sharma General Store&lt;/em&gt;):&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;The Problem:&lt;/strong&gt; He maintained two separate dog-eared notebooks: one for daily rough scribbles (&lt;em&gt;kachha khata&lt;/em&gt;) and one for finalized customer balances (&lt;em&gt;pakka khata&lt;/em&gt;). Updating them took 45 minutes every evening, and customers regularly disputed 3-week-old dues.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The Reaction:&lt;/strong&gt; He was blown away by typing &lt;code&gt;"Ramesh ji 450 udhaar diya 2 packet aata"&lt;/code&gt; and watching it automatically map to Ramesh's account, update his credit limit bar, and generate a polite Hindi WhatsApp reminder with his store's UPI ID in two clicks.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;His Verdict:&lt;/strong&gt; &lt;em&gt;"Agar ye mere phone ya dukaan ke computer pe bina internet ke chal sakta hai aur koi mera hisaab nahi dekhega, toh main diary chhodne ko tayyar hoon."&lt;/em&gt; (&lt;em&gt;"If this runs on my shop computer without internet and nobody spies on my books, I'm ready to abandon paper diaries today."&lt;/em&gt;)&lt;/li&gt;
&lt;/ul&gt;




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

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Primary Category:&lt;/strong&gt; Hacktoberfest Open-Source AI Challenge Week 2: &lt;strong&gt;"Side Hustle"&lt;/strong&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Submission Type:&lt;/strong&gt; Individual Submission&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Built with ❤️ for Hacktoberfest 2026. Empowering local merchants with open-source AI.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>opensource</category>
      <category>ai</category>
    </item>
    <item>
      <title>EcoQuest | Hacktoberfest-Week1</title>
      <dc:creator>Balabhadra</dc:creator>
      <pubDate>Sun, 11 Oct 2026 14:48:00 +0000</pubDate>
      <link>https://dev.to/balabhadra520/ecoquest-hacktoberfest-week1-32ge</link>
      <guid>https://dev.to/balabhadra520/ecoquest-hacktoberfest-week1-32ge</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 day, people walk through their neighbourhoods, local parks, and outdoor trails. They see overflowing bins, littered green spaces, illegal dumping, or polluted waterways — and usually do one of two things: scroll past it or feel helpless to fix it.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;EcoQuest&lt;/strong&gt; is a mobile-first, community-driven environmental action web app built for the &lt;strong&gt;Hacktoberfest 2026 Week 1 "Touch Grass"&lt;/strong&gt; challenge. Its goal is simple: &lt;strong&gt;help people turn outdoor observations into concrete, actionable community reports in under 30 seconds.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Instead of leaving environmental stewardship to bureaucratic delay or passive social media complaints, EcoQuest provides an immediate bridge between noticing a problem and doing something about it safely.&lt;/p&gt;

&lt;h3&gt;
  
  
  Key Features
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;📱 &lt;strong&gt;Mobile-First Outdoor UX:&lt;/strong&gt; Built for real-world outdoor use with quick camera capture, drag-and-drop file uploads, responsive card layouts, and touch-friendly controls.&lt;/li&gt;
&lt;li&gt;🌿 &lt;strong&gt;Smart Categorisation:&lt;/strong&gt; Classifies reports into 5 key outdoor categories:

&lt;ul&gt;
&lt;li&gt;Litter &amp;amp; Debris&lt;/li&gt;
&lt;li&gt;Overflowing Public Bins&lt;/li&gt;
&lt;li&gt;Neglected Green Spaces&lt;/li&gt;
&lt;li&gt;Water Pollution&lt;/li&gt;
&lt;li&gt;Illegal Dumping&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;🛡️ &lt;strong&gt;Confidence &amp;amp; Honest Uncertainty Disclaimers:&lt;/strong&gt; AI output is never treated as infallible truth. Every report displays an explicit confidence score and an uncertainty notice stating that results are automated suggestions and not independently verified.&lt;/li&gt;
&lt;li&gt;👷 &lt;strong&gt;Safe Next-Action Guidance:&lt;/strong&gt; Gives immediate, safety-first recommendations (e.g., &lt;em&gt;"Wear puncture-resistant gloves,"&lt;/em&gt; &lt;em&gt;"Report hazardous bulk items to the municipal council,"&lt;/em&gt; &lt;em&gt;"Organize a small neighborhood sweep"&lt;/em&gt;).&lt;/li&gt;
&lt;li&gt;🔄 &lt;strong&gt;Community Action Workflow:&lt;/strong&gt; A live community feed that tracks issues across clear lifecycle statuses: &lt;strong&gt;Open&lt;/strong&gt; ➔ &lt;strong&gt;In Progress&lt;/strong&gt; ➔ &lt;strong&gt;Resolved&lt;/strong&gt;, empowering neighbors to take ownership and celebrate resolved cleanups.&lt;/li&gt;
&lt;li&gt;🔒 &lt;strong&gt;Privacy-Preserving Architecture:&lt;/strong&gt; Strict client-side EXIF stripping via HTML5 Canvas prevents accidental leakage of home coordinates or camera metadata. Location is strictly general and user-described (no invasive GPS tracking).&lt;/li&gt;
&lt;li&gt;⚡ &lt;strong&gt;Zero-Barrier Sample Data Mode:&lt;/strong&gt; Works immediately offline out of the box with zero external API keys required, making the app 100% testable and demonstrable anywhere.&lt;/li&gt;
&lt;/ul&gt;




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

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Local Running App:&lt;/strong&gt; Accessible at &lt;code&gt;http://localhost:5173&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cover Art &amp;amp; Visuals:&lt;/strong&gt; &lt;code&gt;public/cover.jpg&lt;/code&gt; (included in repository)&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;To run the live interactive demo locally:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git clone https://github.com/balabhadra3141/Hacktoberfest-Week1.git
&lt;span class="nb"&gt;cd &lt;/span&gt;Hacktoberfest-Week1
npm &lt;span class="nb"&gt;install
&lt;/span&gt;npm run dev
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Visit &lt;code&gt;http://localhost:5173&lt;/code&gt; and click &lt;strong&gt;"Load samples"&lt;/strong&gt; to immediately populate the interactive feed, submit new camera reports, and test status transitions.&lt;/p&gt;




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

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Repository:&lt;/strong&gt; &lt;a href="https://github.com/balabhadra3141/Hacktoberfest-Week1" rel="noopener noreferrer"&gt;https://github.com/balabhadra3141/Hacktoberfest-Week1&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;License:&lt;/strong&gt; &lt;a href="https://dev.toLICENSE"&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;EcoQuest is engineered with modern, performant, and privacy-first web tools:&lt;/p&gt;

&lt;h3&gt;
  
  
  Tech Stack
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Frontend:&lt;/strong&gt; React 19, TypeScript, Vite, Tailwind CSS v4, Lucide React, &lt;code&gt;date-fns&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Backend Proxy:&lt;/strong&gt; Lightweight Node.js server (keeps API keys completely server-side)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Storage:&lt;/strong&gt; Browser LocalStorage with persistent CRUD state management&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Swappable AI Architecture (&lt;code&gt;AIProvider&lt;/code&gt; Pattern)
&lt;/h3&gt;

&lt;p&gt;A core design tenet of EcoQuest is that &lt;strong&gt;the UI is completely decoupled from the AI provider&lt;/strong&gt;. In &lt;code&gt;src/lib/providers.ts&lt;/code&gt;, all model interaction adheres to a strict contract:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kr"&gt;interface&lt;/span&gt; &lt;span class="nx"&gt;AIProvider&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kr"&gt;string&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nl"&gt;isOpenWeight&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;boolean&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nl"&gt;licenseUrl&lt;/span&gt;&lt;span class="p"&gt;?:&lt;/span&gt; &lt;span class="kr"&gt;string&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nl"&gt;analyze&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;payload&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;CreateReportPayload&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nb"&gt;Promise&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nx"&gt;AIAnalysis&lt;/span&gt;&lt;span class="o"&gt;&amp;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;p&gt;This interface enables two swappable operational modes:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Sample Provider (Default):&lt;/strong&gt; A deterministic, zero-dependency offline engine that simulates realistic analysis without any API keys or network latency.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Vision-Language Provider (Prototype):&lt;/strong&gt; A lightweight proxy calling Google Gemini 1.5 Flash via a backend server. The API key is stored securely in &lt;code&gt;.env.local&lt;/code&gt; and never exposed to the client.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pluggable Open-Weight Models:&lt;/strong&gt; Designed specifically to be swapped out for self-hosted open-weight vision models such as &lt;strong&gt;LLaVA-1.6&lt;/strong&gt;, &lt;strong&gt;InternVL2&lt;/strong&gt;, or &lt;strong&gt;CLIP&lt;/strong&gt;.&lt;/li&gt;
&lt;/ol&gt;




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

&lt;p&gt;Environmental challenges are fundamentally local, shared, and community-owned. Building environmental infrastructure on closed, proprietary AI creates severe risks:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Community Data Sovereignty:&lt;/strong&gt; When citizens document civic issues, that data should belong to the community and local authorities — not be funneled into proprietary training datasets or held hostage behind commercial paywalls.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Auditability &amp;amp; Algorithmic Trust:&lt;/strong&gt; If an AI model prioritizes or deprioritizes reports, citizens have a right to inspect the prompts and weights. With open-weight models, community members can audit the system to ensure it doesn't bias against underserved neighborhoods.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Longevity &amp;amp; Independence:&lt;/strong&gt; Commercial API endpoints can be deprecated, rate-limited, or price-hiked at any moment. Open-weight models ensure that community tools will continue running decades from now on local hardware.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Zero-Telemetry Privacy:&lt;/strong&gt; Environmental reports frequently contain background imagery of public roads or parks. Running open-weight vision models locally or on community servers means sensitive spatial imagery never leaves the municipal boundary.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Open innovation ensures that technology serves as public infrastructure, not private gatekeeping.&lt;/p&gt;




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

&lt;p&gt;This project was built iteratively using an advanced agentic coding pair-programming workflow:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Rapid architecture design, domain model drafting, and schema definitions.&lt;/li&gt;
&lt;li&gt;Developing robust validation, error states, and EXIF-stripping sanitization.&lt;/li&gt;
&lt;li&gt;Implementing a strict separation between frontend state and backend proxy inference.&lt;/li&gt;
&lt;li&gt;Testing and validating builds with full TypeScript checking and zero warnings.&lt;/li&gt;
&lt;/ul&gt;




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

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Primary:&lt;/strong&gt; Hacktoberfest Open-Source AI Challenge Week 1: "Touch Grass"&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Individual Submission:&lt;/strong&gt; Created and submitted individually.&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Thank you to the Hacktoberfest and DEV teams for promoting open-source innovation and inspiring developers to get outside and touch grass!&lt;/em&gt;&lt;/p&gt;

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