Initial release: GemYum - On-device AI Nutrition Tracking

Kaggle Gemma Sprint 2025 Competition Submission

Features:
- On-device Gemma 3n model for food recognition
- Comprehensive nutrition database (700+ foods)
- Glycemic index tracking for diabetes management
- Privacy-first design with no cloud dependencies
- Health Connect integration
- GPU-accelerated inference

Technical Stack:
- Android (Kotlin)
- TensorFlow Lite
- Jetpack Compose
- SQLite database

This submission demonstrates practical edge AI applications in health and wellness,
running large language models entirely on-device for privacy and offline capability.

Author: sidkandan

.env.example

@@ -0,0 +1,16 @@
+# Copy this to .env and configure for your environment
+
+# Build Configuration
+BUILD_TYPE=debug
+ENABLE_PROGUARD=false
+
+# Model Configuration
+MODEL_PATH=models/
+USE_BUNDLED_MODELS=false
+
+# Database
+DB_PATH=app/src/main/assets/databases/nutrients.db
+BUILD_DB_FROM_SOURCE=true
+
+# Optional: Add your own API keys here
+# USDA_API_KEY=your_key_here

.github/workflows/build-nutrition-database.yml

@@ -0,0 +1,104 @@
+name: Build and Deploy Nutrition Database
+
+on:
+  push:
+    paths:
+      - 'scripts/build_comprehensive_nutrients_db.py'
+      - '.github/workflows/build-nutrition-database.yml'
+  workflow_dispatch:
+    inputs:
+      force_rebuild:
+        description: 'Force rebuild even if no changes'
+        required: false
+        default: false
+        type: boolean
+
+jobs:
+  build-database:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install requests
+    
+    - name: Build nutrition database
+      run: |
+        cd scripts
+        python build_comprehensive_nutrients_db.py --output-dir ../build/databases
+    
+    - name: Upload database artifacts
+      uses: actions/upload-artifact@v3
+      with:
+        name: nutrition-databases
+        path: |
+          build/databases/*.db
+          build/databases/*.db.gz
+          build/databases/*.json
+        retention-days: 30
+    
+    - name: Calculate checksums
+      run: |
+        cd build/databases
+        sha256sum *.db *.db.gz > checksums.txt
+        cat checksums.txt
+    
+    # Deploy to your CDN/hosting service
+    # Example using AWS S3:
+    - name: Configure AWS credentials
+      if: github.ref == 'refs/heads/main'
+      uses: aws-actions/configure-aws-credentials@v2
+      with:
+        aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
+        aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+        aws-region: us-east-1
+    
+    - name: Deploy to S3
+      if: github.ref == 'refs/heads/main'
+      run: |
+        aws s3 sync build/databases/ s3://your-bucket/gemmunch/ \
+          --exclude "*" \
+          --include "*.db.gz" \
+          --include "*.json" \
+          --include "checksums.txt" \
+          --cache-control "max-age=86400"
+    
+    # Alternative: Deploy to GitHub Releases
+    - name: Create Release
+      if: github.ref == 'refs/heads/main'
+      uses: actions/create-release@v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        tag_name: db-v${{ github.run_number }}
+        release_name: Nutrition Database v${{ github.run_number }}
+        body: |
+          Automated nutrition database build.
+          
+          ## Files
+          - `nutrients.db.gz` - Full database (compressed)
+          - `nutrients_lite.db.gz` - Lite database (compressed)
+          - `nutrients_manifest.json` - Version manifest
+          - `checksums.txt` - SHA256 checksums
+        draft: false
+        prerelease: false
+    
+    - name: Upload Release Assets
+      if: github.ref == 'refs/heads/main'
+      uses: actions/upload-release-asset@v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        upload_url: ${{ steps.create_release.outputs.upload_url }}
+        asset_path: ./build/databases/nutrients.db.gz
+        asset_name: nutrients.db.gz
+        asset_content_type: application/gzip

.gitignore

@@ -0,0 +1,141 @@
+# Built application files
+*.apk
+*.aar
+*.ap_
+*.aab
+
+# Files for the ART/Dalvik VM
+*.dex
+
+# Java class files
+*.class
+
+# Generated files
+bin/
+gen/
+out/
+release/
+
+# Gradle files
+.gradle/
+build/
+
+# Local configuration files (NEVER commit these!)
+local.properties
+gradle.properties
+!gradle.properties.template
+
+# Proguard folder
+proguard/
+
+# Log Files
+*.log
+
+# Android Studio Navigation editor temp files
+.navigation/
+
+# Android Studio captures folder
+captures/
+
+# IntelliJ
+*.iml
+.idea/
+*.iws
+
+# Keystore files
+*.jks
+*.keystore
+
+# External native build folder
+.externalNativeBuild
+.cxx/
+
+# Google Services (if using Firebase)
+google-services.json
+
+# Freeline
+freeline.py
+freeline/
+freeline_project_description.json
+
+# fastlane
+fastlane/report.xml
+fastlane/Preview.html
+fastlane/screenshots
+fastlane/test_output
+fastlane/readme.md
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+.venv
+
+# Database files
+*.db
+*.sqlite
+*.db-journal
+
+# API Keys and secrets
+secrets.properties
+apikeys.properties
+*.env
+!.env.example
+
+# MacOS
+.DS_Store
+
+# Test artifacts
+test_results/
+test_images/current_screen.png
+test_images/manual_test_logs.txt
+ui_dump*.xml
+
+# Temporary files
+*.tmp
+*.temp
+*~
+*.swp
+*.bak
+*.backup
+
+# Model files (too large)
+*.tflite
+*.bin
+*.onnx
+models/gemma*
+models/*/
+
+# Large model files (don't commit to repo)
+*.task
+gemma-3n-*.task
+bundled_models/
+GemYum-v1.0-offline-package/
+GemYum-v1.0-offline-package.zip
+GemYum-v1.0-release.apk
+GemYum-v1.0-sideload.apk
+
+# Keep the nutrients database (it's essential and small)
+!app/src/main/assets/databases/nutrients.db
+
+# Private notes and planning
+ProjectPlanning/
+ClaudeDevelopmentNotes.md
+2025-*.txt
+VIDEO_SCRIPT.md
+PROBLEM_STATEMENT.md
+DEMO_FLOW.md
+SUBMISSION_CHECKLIST.md
+PACKAGE_CONTENTS.md
+
+# Scripts data (can be regenerated)
+scripts/nutrition_data/
+scripts/__pycache__/
+scripts/*.db
+scripts/*.db-journal
+scripts/*.db.gz
+!scripts/build_ultimate_nutrients_db.py