<?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: Kourtney Lee</title>
    <description>The latest articles on DEV Community by Kourtney Lee (@kourtneylee1611).</description>
    <link>https://dev.to/kourtneylee1611</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.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F3842312%2F490cdedd-032c-4f69-9cac-2c390c2672ef.jpg</url>
      <title>DEV Community: Kourtney Lee</title>
      <link>https://dev.to/kourtneylee1611</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/kourtneylee1611"/>
    <language>en</language>
    <item>
      <title>Snap Your Fridge, Get a Recipe: Building PantryLens with Gemma 4</title>
      <dc:creator>Kourtney Lee</dc:creator>
      <pubDate>Sun, 24 May 2026 07:45:21 +0000</pubDate>
      <link>https://dev.to/kourtneylee1611/snap-your-fridge-get-a-recipe-building-pantrylens-with-gemma-4-5bfm</link>
      <guid>https://dev.to/kourtneylee1611/snap-your-fridge-get-a-recipe-building-pantrylens-with-gemma-4-5bfm</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for the &lt;a href="https://dev.to/challenges/google-gemma-2026-05-06"&gt;Gemma 4 Challenge: Build with Gemma 4&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

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

&lt;p&gt;&lt;strong&gt;PantryLens&lt;/strong&gt; — a free, installable Progressive Web App that turns a photo of your fridge or pantry into a complete, ready-to-cook recipe in seconds.&lt;/p&gt;

&lt;p&gt;The idea is simple: food waste is a real problem, and one of its biggest causes is not knowing what to cook with what you already have. PantryLens removes that friction entirely. You open the app, snap up to 3 photos of your ingredients, tap Generate Recipe, and watch a full recipe stream to your screen — live, token by token — before you even put your phone down.&lt;/p&gt;

&lt;p&gt;Key features:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;📷 Camera capture, file upload, or drag-and-drop (up to 3 images)&lt;/li&gt;
&lt;li&gt;⚡ Recipe streams live to the screen as Gemma 4 generates it&lt;/li&gt;
&lt;li&gt;📱 Installable PWA — works on iOS and Android home screens, no App Store needed&lt;/li&gt;
&lt;li&gt;🔒 No account, no login, no data stored — your photos never leave the request cycle&lt;/li&gt;
&lt;li&gt;🆓 Completely free to use&lt;/li&gt;
&lt;/ul&gt;

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


&lt;div&gt;
    &lt;iframe src="https://www.youtube.com/embed/dJ_dXbfLIX0"&gt;
    &lt;/iframe&gt;
  &lt;/div&gt;


&lt;p&gt;Live app: &lt;a href="https://pantry-lens-one.vercel.app" rel="noopener noreferrer"&gt;https://pantry-lens-one.vercel.app&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Install on your mobile home screen: Open the web app in the browser and use the built-in "Add to Home Screen" feature&lt;/p&gt;

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

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2Fblsn0ci996oo28od7txy.PNG" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2Fblsn0ci996oo28od7txy.PNG" alt="PWA-pin-to-home" width="800" height="1732"&gt;&lt;/a&gt;&lt;/p&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/klee1611" rel="noopener noreferrer"&gt;
        klee1611
      &lt;/a&gt; / &lt;a href="https://github.com/klee1611/PantryLens" rel="noopener noreferrer"&gt;
        PantryLens
      &lt;/a&gt;
    &lt;/h2&gt;
    &lt;h3&gt;
      Turn your fridge photos into recipes — PWA powered by Google Gemma 4 via OpenRouter. Built for the Google Gemma 4 Hackathon on DEV.
    &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;PantryLens&lt;/h1&gt;
&lt;/div&gt;
&lt;blockquote&gt;
&lt;p&gt;Snap a photo of your fridge or pantry — get a recipe in seconds.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;PantryLens is a progressive web app (PWA) that uses AI vision (Google Gemma 4) to identify ingredients from photos and stream a complete recipe directly to the screen, token by token.&lt;/p&gt;

&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;How it works&lt;/h2&gt;
&lt;/div&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Capture&lt;/strong&gt; — take a photo with your camera, upload from your gallery, or drag and drop (up to 3 images)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Compress&lt;/strong&gt; — the browser Canvas API resizes each image client-side to ≤1024 px before upload&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Analyze&lt;/strong&gt; — a Next.js Edge Function proxies the images to OpenRouter's vision model&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Stream&lt;/strong&gt; — the recipe streams back token-by-token, rendered progressively as Markdown&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;Demo&lt;/h2&gt;
&lt;/div&gt;

  
    
    

    &lt;span class="m-1"&gt;demo.mp4&lt;/span&gt;
    
  

  

  


&lt;div class="markdown-heading"&gt;
&lt;h3 class="heading-element"&gt;Pin PWA to mobile home screen&lt;/h3&gt;

&lt;/div&gt;
&lt;a rel="noopener noreferrer" href="https://private-user-images.githubusercontent.com/9849212/597283240-439a48f1-59ac-45de-ad50-34de45d8967d.PNG?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Nzk4NjI3OTAsIm5iZiI6MTc3OTg2MjQ5MCwicGF0aCI6Ii85ODQ5MjEyLzU5NzI4MzI0MC00MzlhNDhmMS01OWFjLTQ1ZGUtYWQ1MC0zNGRlNDVkODk2N2QuUE5HP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDUyNyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA1MjdUMDYxNDUwWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9NDFkZDQ4MmRkNjIyMzJiMzcxMDIzZmY1MDBmOTBiMzhhYjk5ZjliYjRhZDRkMmYyOTcwMzI0NDM0YzVjNWI3NSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.wf8HyrkS-uDfBHk7DDfGCiRfVo-UvVoxPbPk49OgPwQ"&gt;&lt;img width="282" height="609" alt="PWA-1" src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fprivate-user-images.githubusercontent.com%2F9849212%2F597283240-439a48f1-59ac-45de-ad50-34de45d8967d.PNG%3Fjwt%3DeyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Nzk4NjI3OTAsIm5iZiI6MTc3OTg2MjQ5MCwicGF0aCI6Ii85ODQ5MjEyLzU5NzI4MzI0MC00MzlhNDhmMS01OWFjLTQ1ZGUtYWQ1MC0zNGRlNDVkODk2N2QuUE5HP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDUyNyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA1MjdUMDYxNDUwWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9NDFkZDQ4MmRkNjIyMzJiMzcxMDIzZmY1MDBmOTBiMzhhYjk5ZjliYjRhZDRkMmYyOTcwMzI0NDM0YzVjNWI3NSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.wf8HyrkS-uDfBHk7DDfGCiRfVo-UvVoxPbPk49OgPwQ" class="js-gh-image-fallback"&gt;&lt;/a&gt;
&lt;a rel="noopener noreferrer" href="https://private-user-images.githubusercontent.com/9849212/597283244-29cdecad-88a0-4024-bc4c-c122a01be94a.PNG?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Nzk4NjI3OTAsIm5iZiI6MTc3OTg2MjQ5MCwicGF0aCI6Ii85ODQ5MjEyLzU5NzI4MzI0NC0yOWNkZWNhZC04OGEwLTQwMjQtYmM0Yy1jMTIyYTAxYmU5NGEuUE5HP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDUyNyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA1MjdUMDYxNDUwWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9YjkwNDdlYWVmYjE2NGQ2ZjU3ZmFkNTc5NzI3ZmEyMjNlOTRhMzZhNTMzZGVmNDA3OTQ1ZDI5ODMwMDVmNzZlOSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.47NyvJ6qaw0sZvtRG73d4pG7xZEgI1menQ_eDEs5bK8"&gt;&lt;img width="282" height="609" alt="PWA-2" src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fprivate-user-images.githubusercontent.com%2F9849212%2F597283244-29cdecad-88a0-4024-bc4c-c122a01be94a.PNG%3Fjwt%3DeyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Nzk4NjI3OTAsIm5iZiI6MTc3OTg2MjQ5MCwicGF0aCI6Ii85ODQ5MjEyLzU5NzI4MzI0NC0yOWNkZWNhZC04OGEwLTQwMjQtYmM0Yy1jMTIyYTAxYmU5NGEuUE5HP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDUyNyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA1MjdUMDYxNDUwWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9YjkwNDdlYWVmYjE2NGQ2ZjU3ZmFkNTc5NzI3ZmEyMjNlOTRhMzZhNTMzZGVmNDA3OTQ1ZDI5ODMwMDVmNzZlOSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.47NyvJ6qaw0sZvtRG73d4pG7xZEgI1menQ_eDEs5bK8" class="js-gh-image-fallback"&gt;&lt;/a&gt;

&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;Tech stack&lt;/h2&gt;

&lt;/div&gt;
&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Layer&lt;/th&gt;
&lt;th&gt;Technology&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Framework&lt;/td&gt;
&lt;td&gt;Next.js 16 (App Router, Edge Runtime)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;UI&lt;/td&gt;
&lt;td&gt;React 19, Tailwind CSS, react-markdown&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AI&lt;/td&gt;
&lt;td&gt;OpenRouter — &lt;code&gt;google/gemma-4-26b-a4b-it&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Rate limiting&lt;/td&gt;
&lt;td&gt;Upstash Redis (sliding window, 5 req/IP/hour)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Testing&lt;/td&gt;
&lt;td&gt;Jest 29, Testing Library,&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;…&lt;/div&gt;
  &lt;/div&gt;
  &lt;div class="gh-btn-container"&gt;&lt;a class="gh-btn" href="https://github.com/klee1611/PantryLens" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


&lt;p&gt;The project is fully open source under the MIT license. The stack:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Layer&lt;/th&gt;
&lt;th&gt;Technology&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Framework&lt;/td&gt;
&lt;td&gt;Next.js 16 (App Router, Edge Runtime)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;UI&lt;/td&gt;
&lt;td&gt;React 19, Tailwind CSS, react-markdown&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AI model&lt;/td&gt;
&lt;td&gt;Gemma 4 via OpenRouter&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Rate limiting&lt;/td&gt;
&lt;td&gt;Upstash Redis (sliding window, 5 req/IP/hour)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Deploy&lt;/td&gt;
&lt;td&gt;Vercel&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  How I Used Gemma 4
&lt;/h2&gt;

&lt;p&gt;The model: &lt;strong&gt;google/gemma-4-26b-a4b-it&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;I used &lt;strong&gt;Gemma 4 26B A4B&lt;/strong&gt; — the 26B total parameter Mixture-of-Experts model with 4B active parameters per forward pass, instruction-tuned. I accessed it through OpenRouter using the model ID google/gemma-4-26b-a4b-it to meet the following requirements:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Vision capability&lt;/strong&gt; — PantryLens is fundamentally a vision task. The model needs to look at a photo of a messy fridge shelf and accurately identify eggs, half-used condiments, wilting vegetables, and leftover containers. Gemma 4's multimodal architecture handles this reliably, even for cluttered or poorly lit photos.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Instruction following&lt;/strong&gt; — generating a well-structured recipe means strictly following a Markdown template with headings, bullet lists, and numbered steps. The instruction-tuned variant follows these formatting constraints consistently, which is critical for the progressive rendering to look correct as it streams.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Speed vs. quality balance&lt;/strong&gt; — the MoE architecture means the model activates only 4B parameters per token while drawing on the full 26B parameter knowledge base. In practice, this produces recipe quality close to the denser models at latency that works well for streaming UX.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Compare different models of Gemma 4 for this use case:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;Why reject the Edge 2B (E2B) model? While E2B is phenomenal for air-gapped, localized execution, its compressed parameter count lacks the deep "world knowledge" required for cooking.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Why reject the Full Precision 31B model? Uncompressed FP16/BF16 models demand massive VRAM clusters. In a serverless architecture, this translates to an unacceptable Time-to-First-Token (TTFT), virtually guaranteeing HTTP 504 gateway timeouts before the proxy can return data.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;The Optimal Route (26B-A4B): Utilizing the 4-bit Activation-Aware Quantized (A4B) variant delivered the exact sweet spot. It retains near-frontier reasoning capabilities for complex visual extraction, but the 4-bit memory footprint drastically accelerates upstream inference, enabling ultra-low latency token generation.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  The architecture: an opaque streaming proxy
&lt;/h3&gt;

&lt;p&gt;The most interesting engineering decision was how the model is integrated. The frontend never touches the API key or sees the system prompt. Here's the full flow:&lt;/p&gt;

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

&lt;p&gt;The Next.js API route runs on the Vercel Function using &lt;strong&gt;Edge Runtime&lt;/strong&gt; for quick cold starts and low geographical latency. The 300-second timeout limit is acceptable since the response is unlikely to keep streaming for that long.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Client-side image compression&lt;/strong&gt; was another non-obvious requirement. Vercel Function has a payload limit of 4.5 MB. Raw iPhone photos are 4–12 MB each — three of them would blow the limit before a single byte of AI processing begins. The solution: compress each image on-device using the browser's Canvas API (resize to ≤1024px, JPEG at 75% quality) before the upload. A 10 MB photo becomes ~150 KB. This happens invisibly in under a second on any modern device, including older iPhones.&lt;/p&gt;

&lt;h3&gt;
  
  
  The system prompt
&lt;/h3&gt;

&lt;p&gt;Getting Gemma 4 to output clean, consistently structured Markdown for streaming required careful prompt engineering. The key lessons:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Explicit blank-line rules&lt;/strong&gt;: without being told explicitly that every ### heading must have a blank line before and after it, the model occasionally merged headings and body text onto the same line, which broke the Markdown renderer.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Numbered list enforcement&lt;/strong&gt;: instructions would sometimes collapse into a single paragraph unless the prompt explicitly stated "each step must be on its own line — never merge steps into a paragraph."&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pantry staples assumption&lt;/strong&gt;: by default the model sometimes refused to generate a recipe if it couldn't see salt or oil in the photo. Telling it to assume common pantry staples are always on hand (even if not visible) fixed this.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Single-response constraint&lt;/strong&gt;: without explicit instruction to never ask follow-up questions, the model occasionally responded with clarifying questions ("Are these all the ingredients?") instead of generating the recipe immediately.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The final prompt includes a section of explicit formatting rules before the template:&lt;/p&gt;

&lt;p&gt;FORMATTING RULES — follow exactly:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;The recipe title uses ## (two hashes). It must be alone on its own line.&lt;/li&gt;
&lt;li&gt;Each section header uses ### (three hashes). It must be alone on its own line.&lt;/li&gt;
&lt;li&gt;Every heading must have one blank line before it AND one blank line after it.&lt;/li&gt;
&lt;li&gt;The instructions section is a numbered list. Each step is on its own line. Never merge steps into a paragraph.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Application Design Wrapping Up
&lt;/h3&gt;

&lt;p&gt;The architecture here — Edge Function as opaque AI proxy, client-side compression, streaming passthrough — is a reusable pattern for any vision AI application that needs to:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Keep API credentials out of the frontend&lt;/li&gt;
&lt;li&gt;Handle large image payloads within serverless limits&lt;/li&gt;
&lt;li&gt;Deliver a live "typing" UX without server timeouts&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;PantryLens is the simplest possible version of this pattern, which makes the code easy to read and adapt.&lt;/p&gt;

</description>
      <category>devchallenge</category>
      <category>gemmachallenge</category>
      <category>gemma</category>
    </item>
    <item>
      <title>AuroraPath - Chasing the northern lights | Earth Day Weekend Challenge</title>
      <dc:creator>Kourtney Lee</dc:creator>
      <pubDate>Mon, 20 Apr 2026 03:51:28 +0000</pubDate>
      <link>https://dev.to/kourtneylee1611/aurorapath-chasing-the-northern-lights-479l</link>
      <guid>https://dev.to/kourtneylee1611/aurorapath-chasing-the-northern-lights-479l</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for &lt;a href="https://dev.to/challenges/weekend-2026-04-16"&gt;Weekend Challenge: Earth Day Edition&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

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

&lt;p&gt;&lt;strong&gt;AuroraPath&lt;/strong&gt; — a real-time, carbon-optimized dashboard for sustainable aurora borealis viewing. 🌌🌿&lt;/p&gt;

&lt;p&gt;Aurora hunting typically means driving long distances into rural darkness alone at night — one of the least carbon-efficient leisure activities imaginable. AuroraPath flips that script: it combines live NOAA space weather data with an Auth0-managed AI agent that generates travel recommendations prioritizing trains, buses, and carpooling over solo drives.&lt;/p&gt;

&lt;p&gt;Auth0 is the backbone of AuroraPath's trust model. It enforces two distinct identity layers:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Human identity (User Auth)&lt;/strong&gt; — Only authenticated users can invoke the AI. This prevents anonymous abuse of the Gemini API budget and ensures every recommendation is tied to a real account.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Machine identity (M2M Agent Auth)&lt;/strong&gt; — The Gemini AI orchestrator runs under its own dedicated Auth0 Machine-to-Machine credential, completely separate from user auth. The AI agent has a traceable, revocable identity — if the M2M token is rotated or revoked, the AI stops calling Gemini without touching a single user session.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;The remaining features are built on top of this trust foundation:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Aurora Visibility Score (AVS)&lt;/strong&gt; — a deterministic 0–100 score from live NOAA G-scale indices and solar wind speed&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Real-time geomagnetic dashboard&lt;/strong&gt; — G/R/S-scale meters, solar wind, 24/48h forecasts, auto-refreshing from NOAA SWPC&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Interactive map&lt;/strong&gt; — latitude-based aurora visibility bands that update with geomagnetic conditions&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Green Path AI recommendations&lt;/strong&gt; — 3 nearby dark-sky spots with public transit directions, CO₂ saved vs. solo driving, and dark-sky ratings — only unlocked when Auth0 confirms the user's identity&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Per-user daily quota&lt;/strong&gt; — Upstash Redis tracks each Auth0 user's Gemini calls (10/day) using a hashed sub claim as the key&lt;/li&gt;
&lt;/ul&gt;

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

&lt;p&gt;🔗 Project URL: &lt;a href="https://aurora-path.vercel.app/" rel="noopener noreferrer"&gt;https://aurora-path.vercel.app/&lt;/a&gt; &lt;/p&gt;

&lt;p&gt;The dashboard loads with live NOAA data immediately. Click "Find My Green Path" — Auth0 Universal Login appears if you're not signed in. Once authenticated, the AI agent (operating under its own M2M credential) generates sustainable viewing routes near your GPS location.&lt;/p&gt;

&lt;p&gt;  &lt;iframe src="https://www.youtube.com/embed/aWTghy5_DFc"&gt;
  &lt;/iframe&gt;
&lt;/p&gt;

&lt;p&gt;⚠️ &lt;strong&gt;Hackathon Note:&lt;/strong&gt; Green Path uses Google AI Studio free tier (100 req/day shared). If it returns an error, the daily quota may be exhausted. The Aurora dashboard always works regardless.&lt;/p&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/klee1611" rel="noopener noreferrer"&gt;
        klee1611
      &lt;/a&gt; / &lt;a href="https://github.com/klee1611/AuroraPath" rel="noopener noreferrer"&gt;
        AuroraPath
      &lt;/a&gt;
    &lt;/h2&gt;
    &lt;h3&gt;
      🌌 Carbon-optimized aurora sighting dashboard — Earth Day 2026 Hackathon
    &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;AuroraPath 🌌&lt;/h1&gt;
&lt;/div&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Sustainable Aurora Viewing — Earth Day Hackathon 2026&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;A real-time, carbon-optimized dashboard for aurora borealis sightings
Built for the &lt;a href="https://dev.to/challenges/weekend-2026-04-16" rel="nofollow"&gt;dev.to Earth Day Weekend Challenge&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;a href="https://vercel.com/new/clone?repository-url=https://github.com/YOUR_REPO" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/7015516519ae874ab75537283bc75f86b3d46386ed994093a3790a1180913164/68747470733a2f2f76657263656c2e636f6d2f627574746f6e" alt="Deploy with Vercel"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;✨ What It Does&lt;/h2&gt;
&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;AuroraPath&lt;/strong&gt; combines live NOAA space weather data with Google Gemini AI to help you:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Track real-time aurora activity&lt;/strong&gt; — Aurora Visibility Score (AVS), G/R/S-scale meters, solar wind speed&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;See where auroras are visible&lt;/strong&gt; — Interactive map with latitude visibility bands that update with geomagnetic conditions&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Find sustainable viewing routes&lt;/strong&gt; — AI-generated "Green Path" recommendations with carbon savings, public transit options, and dark-sky ratings&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;🧬 Aurora Visibility Score (AVS)&lt;/h2&gt;

&lt;/div&gt;
&lt;p&gt;An empirical model based on NOAA space weather indices:&lt;/p&gt;
&lt;div class="snippet-clipboard-content notranslate position-relative overflow-auto"&gt;&lt;pre class="notranslate"&gt;&lt;code&gt;AVS = (G-Scale/5 × 65) + (max(windSpeed - 300, 0)/500 × 25) + forecastBonus
&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Score&lt;/th&gt;
&lt;th&gt;Level&lt;/th&gt;
&lt;th&gt;Meaning&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;80–100&lt;/td&gt;
&lt;td&gt;🌌 Excellent&lt;/td&gt;
&lt;td&gt;Visible at mid-latitudes (≥45°N)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;60–79&lt;/td&gt;
&lt;td&gt;✨ High&lt;/td&gt;
&lt;td&gt;Strong activity at high latitudes&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;35–59&lt;/td&gt;
&lt;td&gt;🌠 Moderate&lt;/td&gt;
&lt;td&gt;Visible at polar regions (≥60°N)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;10–34&lt;/td&gt;
&lt;td&gt;🌃&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;…&lt;/div&gt;
  &lt;/div&gt;
  &lt;div class="gh-btn-container"&gt;&lt;a class="gh-btn" href="https://github.com/klee1611/AuroraPath" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


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

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

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

&lt;h3&gt;
  
  
  Two-Layer Auth0 Identity Model
&lt;/h3&gt;

&lt;p&gt;The most interesting architectural decision was treating user identity and AI agent identity as separate&lt;br&gt;
concerns:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Layer 1 — User Auth (Regular Web App)&lt;/strong&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;User → Auth0 Universal Login → Session cookie (httpOnly, SameSite)
                                      ↓
/api/green-path checks getSession() → rejects anonymous requests (401)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Layer 2 — Agent Auth (M2M Application)&lt;/strong&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;/api/green-path → Auth0 /oauth/token (client_credentials grant)
                        ↓
                M2M access token → logged as agentId in every response 
                (revocable independently of all user sessions)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Every AI recommendation response includes:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="nl"&gt;"agentId"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"auth0-m2m|..."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="nl"&gt;"generatedAt"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"2026-04-19T..."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="nl"&gt;"quota"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"remaining"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"limit"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;5&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"resetAt"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"..."&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This makes the AI fully auditable: you know who asked (Auth0 user sub) and who acted (Auth0 M2M agent ID) for every call.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Aurora Visibility Score (AVS)&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Rather than showing raw space-weather indices, a deterministic scoring model converts them to a 0–100 scale:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;AVS = (G-Scale/5 × 65) + (max(windSpeed − 300, 0)/500 × 25) + forecastBonus
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;G-Scale (65% weight)&lt;/strong&gt; — NOAA's geomagnetic storm index, the primary aurora driver&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Solar wind speed (25% weight)&lt;/strong&gt; — elevated wind (&amp;gt;300 km/s) correlates with aurora enhancement&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Forecast bonus (+3–5 pts)&lt;/strong&gt; — rewards stable or improving 24h conditions&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The AVS gates the Green Path feature: users below AVS 10 ("None" activity) cannot trigger AI recommendations — there's no point generating eco-travel routes when there's nothing to see.&lt;/p&gt;

&lt;h3&gt;
  
  
  Gemini Green Path
&lt;/h3&gt;

&lt;p&gt;The Gemini prompt injects the AVS score, G-scale, and reverse-geocoded region (resolved server-side to protect user GPS privacy), then requests structured JSON directly — no markdown parsing needed. Before any Gemini call:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Auth0 session verified (user layer)&lt;/li&gt;
&lt;li&gt;Auth0 M2M token fetched (agent layer)&lt;/li&gt;
&lt;li&gt;Upstash Redis quota checked (ratelimit:{sha256(userId)[0:32]}:{YYYY-MM-DD})&lt;/li&gt;
&lt;li&gt;Input sanitized (sanitizeRegion() strips control chars, caps at 100 chars)&lt;/li&gt;
&lt;li&gt;Gemini called with 30s timeout&lt;/li&gt;
&lt;/ol&gt;

&lt;h3&gt;
  
  
  Security Hardening
&lt;/h3&gt;

&lt;p&gt;Full 7-phase audit conducted:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Per-user Gemini quota via Upstash Redis (hashed sub, in-memory fallback for dev)&lt;/li&gt;
&lt;li&gt;IP rate limiting (30 req/min) on public /api/aurora&lt;/li&gt;
&lt;li&gt;Server-side Nominatim proxy — raw GPS never leaves the server&lt;/li&gt;
&lt;li&gt;5 HTTP security headers: HSTS, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy&lt;/li&gt;
&lt;li&gt;CORS restricted to own AUTH0_BASE_URL origin&lt;/li&gt;
&lt;/ul&gt;

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

&lt;p&gt;🔐 &lt;strong&gt;Best Use of Auth0 for Agents&lt;/strong&gt; - AuroraPath implements the full Auth0 for Agents pattern: a dedicated M2M application gives the Gemini AI orchestrator its own managed identity, completely decoupled from user auth.&lt;br&gt;
Every AI recommendation is traceable to both a human (user.sub) and a machine (agentId). The M2M credential can be rotated or revoked without impacting any user session. The per-user daily quota uses the Auth0 sub claim (SHA-256 hashed) as the Redis key — Auth0 identity drives resource governance end-to-end.&lt;/p&gt;

&lt;p&gt;✨ &lt;strong&gt;Best Use of Google Gemini&lt;/strong&gt; - Gemini 1.5 Flash powers the Green Path feature — generating 3 location-aware sustainable aurora viewing recommendations as structured JSON, dynamically conditioned on the live AVS score and geomagnetic context. The model is only invoked after passing both Auth0 authentication layers and the Upstash quota check.&lt;/p&gt;

</description>
      <category>devchallenge</category>
      <category>weekendchallenge</category>
      <category>ai</category>
      <category>auth0challenge</category>
    </item>
    <item>
      <title>Never Miss an AI Hackathon Again: Building an Autonomous Discovery Agent with Notion &amp; Brave MCP</title>
      <dc:creator>Kourtney Lee</dc:creator>
      <pubDate>Mon, 30 Mar 2026 00:10:15 +0000</pubDate>
      <link>https://dev.to/kourtneylee1611/never-miss-an-ai-hackathon-again-building-an-autonomous-discovery-agent-with-notion-brave-mcp-1kjg</link>
      <guid>https://dev.to/kourtneylee1611/never-miss-an-ai-hackathon-again-building-an-autonomous-discovery-agent-with-notion-brave-mcp-1kjg</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for the &lt;a href="https://dev.to/challenges/notion-2026-03-04"&gt;Notion MCP Challenge&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

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

&lt;p&gt;&lt;strong&gt;HackathonSniper&lt;/strong&gt; is an autonomous AI agent designed to eliminate "hackathon fatigue." If you're like me, you spend hours every month checking Devpost, DoraHacks, and Dev.to just to find one hackathon that fits your niche. &lt;/p&gt;

&lt;p&gt;HackathonSniper turns this manual hunt into an automated pipeline. It doesn't just "search"—it &lt;strong&gt;thinks&lt;/strong&gt;. It uses the Model Context Protocol (MCP) to bridge the gap between AI reasoning and the real web.&lt;/p&gt;

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

&lt;p&gt;  &lt;iframe src="https://www.youtube.com/embed/eGlTIzBa2hI"&gt;
  &lt;/iframe&gt;
&lt;/p&gt;

&lt;h2&gt;
  
  
  Show us the 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/klee1611" rel="noopener noreferrer"&gt;
        klee1611
      &lt;/a&gt; / &lt;a href="https://github.com/klee1611/HackathonSniper" rel="noopener noreferrer"&gt;
        HackathonSniper
      &lt;/a&gt;
    &lt;/h2&gt;
    &lt;h3&gt;
      AI-powered hackathon discovery agent using Brave Search + Notion MCP
    &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;Hackathon Sniper 🎯 — AI-Powered Hackathon Discovery Agent&lt;/h1&gt;
&lt;/div&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Hackathon Sniper&lt;/strong&gt; is a TypeScript agent that automatically discovers, evaluates, and tracks hackathons using AI-powered analysis, real MCP server integration, and strict environment separation. Point it at the web; it returns only the hackathons worth entering.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;strong&gt;What it does in one sentence:&lt;/strong&gt; Hackathon Sniper searches the web for hackathons, scores each one against your criteria with a Groq-powered AI evaluator, and saves qualified results directly to a Notion database — all in a single command.&lt;/p&gt;
&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;Features ✨&lt;/h2&gt;
&lt;/div&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Intelligent Search 🔍&lt;/strong&gt; — Real Brave Search MCP server integration&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;AI Evaluation 🤖&lt;/strong&gt; — Groq-powered hackathon qualification analysis&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Notion Integration 📊&lt;/strong&gt; — Real Notion MCP server for storage and tracking&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Test Isolation 🎭&lt;/strong&gt; — Complete environment isolation for testing (zero external dependencies)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Fast Development ⚡&lt;/strong&gt; — Hot reload, comprehensive Makefile, pnpm package management&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Type Safety 🛡️&lt;/strong&gt; — End-to-end TypeScript with Zod schema validation&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Robust Testing&lt;/strong&gt;…&lt;/li&gt;
&lt;/ul&gt;
&lt;/div&gt;
  &lt;/div&gt;
  &lt;div class="gh-btn-container"&gt;&lt;a class="gh-btn" href="https://github.com/klee1611/HackathonSniper" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


&lt;h3&gt;
  
  
  The Technical Architecture
&lt;/h3&gt;

&lt;p&gt;The agent follows a rigorous 3-phase lifecycle:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;🔍 The Hunt (Brave Search MCP)&lt;/strong&gt;: It performs targeted searches across the web to find new hackathon announcements, even those buried in blog posts or obscure landing pages.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;🤖 The Vetting (Groq LLM)&lt;/strong&gt;: Every discovery is analyzed by a Llama-3 model. It evaluates the prize pool, solo-friendliness, AI relevance, and proximity to the deadline.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;📊 The Storage (Notion MCP)&lt;/strong&gt;: Qualified opportunities are instantly synced to a beautifully structured Notion database, complete with metadata, deadlines, and AI-generated summaries.&lt;/li&gt;
&lt;/ol&gt;

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

&lt;h2&gt;
  
  
  How I Used Notion MCP
&lt;/h2&gt;

&lt;p&gt;The &lt;strong&gt;Notion MCP Server&lt;/strong&gt; (&lt;code&gt;@notionhq/notion-mcp-server&lt;/code&gt;) is the "nervous system" of this project. It transforms a simple script into a powerful productivity tool by allowing the AI to interact with my Notion workspace as if it were a native application.&lt;/p&gt;

&lt;p&gt;Instead of writing complex, boilerplate-heavy API calls to the Notion REST API, the Notion MCP is integrated. This allowed the agent to:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Dynamic Schema Mapping&lt;/strong&gt;: The agent automatically maps structured AI evaluation objects to Notion database properties (Dates, Checkboxes, URLs, and Rich Text).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Process Isolation&lt;/strong&gt;: By using the MCP &lt;code&gt;StdioClientTransport&lt;/code&gt;, the Notion integration runs in its own isolated process, managed entirely by the Model Context Protocol.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Automated Workflows&lt;/strong&gt;: The agent uses the &lt;code&gt;create_notion_page&lt;/code&gt; tool provided by the MCP server to dynamically populate my "Hackathon Scout" dashboard.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Wrapping Up
&lt;/h3&gt;

&lt;p&gt;This integration unlocks a "set and forget" workflow. I can run HackathonSniper as a background task, and my Notion workspace stays updated with a high-signal, low-noise list of opportunities. It’s not just data entry; it’s an &lt;strong&gt;autonomous data clerk&lt;/strong&gt; powered by Notion MCP.&lt;/p&gt;

</description>
      <category>devchallenge</category>
      <category>notionchallenge</category>
      <category>mcp</category>
      <category>ai</category>
    </item>
  </channel>
</rss>
