tinkerhub · y-syntax · Aug 2, 2025 · coderabbitai · Aug 2, 2025 · coderabbitai
diff --git a/README.md b/README.md
@@ -1,102 +1,81 @@
 <img width="3188" height="1202" alt="frame (3)" src="https://github.com/user-attachments/assets/517ad8e9-ad22-457d-9538-a9e62d137cd7" />
 
-
-# [Project Name] 🎯
-
+# Roastberry-Pi 🎯
 
 ## Basic Details
-### Team Name: [Name]
-
+### Team Name: MAIN
 
 ### Team Members
-- Team Lead: [Name] - [College]
-- Member 2: [Name] - [College]
-- Member 3: [Name] - [College]
+- Team Lead: Yadu S Rajeev - TKM College of Engineering, Kollam
+- Member 2: Vaishnav V Bishoy - TKM College of Engineering, Kollam
 
 ### Project Description
-[2-3 lines about what your project does]
+Face-to-Fruit is a comic-themed web app that hilariously matches your selfie to a fruit or veggie and roasts you with a savage, personalized caption.
 
 ### The Problem (that doesn't exist)
-[What ridiculous problem are you solving?]
+Not enough people know which vegetable or fruit they spiritually resemble. The world lacks official roast certificates from produce.
 
 ### The Solution (that nobody asked for)
-[How are you solving it? Keep it fun!]
+A face detection-powered web app that assigns you your "spirit produce" and roasts you based on your face's vibe. Download and share your Roast Certificate for ultimate bragging/shaming rights!
 
 ## Technical Details
 ### Technologies/Components Used
 For Software:
-- [Languages used]
-- [Frameworks used]
-- [Libraries used]
-- [Tools used]
+- JavaScript, HTML
+- None (vanilla)
+- face-api.js, Canvas API
+- VSCode Live Server
 
 For Hardware:
-- [List main components]
-- [List specifications]
-- [List tools required]
+- None required
+- Any device with a browser & camera
+- No additional tools needed
 
-### Implementation
-For Software:
-# Installation
-[commands]
+## Important Note
 
-# Run
-[commands]
+This app requires downloading the repository and running it locally in a browser using a local web server.
+Due to use of AI models and browser file upload & security restrictions, this project will **NOT run properly if you simply open the HTML pages directly or via GitHub Pages**.
 
-### Project Documentation
+### Implementation
 For Software:
 
-# Screenshots (Add at least 3)
-![Screenshot1](Add screenshot 1 here with proper name)
-*Add caption explaining what this shows*
-
-![Screenshot2](Add screenshot 2 here with proper name)
-*Add caption explaining what this shows*
-
-![Screenshot3](Add screenshot 3 here with proper name)
-*Add caption explaining what this shows*
-
-# Diagrams
-![Workflow](Add your workflow/architecture diagram here)
-*Add caption explaining your workflow*
-
-For Hardware:
-
-# Schematic & Circuit
-![Circuit](Add your circuit diagram here)
-*Add caption explaining connections*
-
-![Schematic](Add your schematic diagram here)
-*Add caption explaining the schematic*
-
-# Build Photos
-![Components](Add photo of your components here)
-*List out all components shown*
+# Installation
+```bash
+# 1. Clone repo and enter folder
+git clone https://github.com/y-syntax/Roastberry-Pi.git
+cd face-to-fruit
 
-![Build](Add photos of build process here)
-*Explain the build steps*
+# 2. Download face-api.min.js from CDN or GitHub releases and place in folder
 
-![Final](Add photo of final product here)
-*Explain the final build*
+# 3. Download face-api.js /models folder from official repo and place in folder
 
-### Project Demo
+# 4. Collect all images (potato.png, tomato.png, etc.) and put in /images/
-# 2. Download face-api.min.js from CDN or GitHub releases and place in folder
-
-![Final](Add photo of final product here)
-*Explain the final build*
-# 3. Download face-api.js /models folder from official repo and place in folder
-
-### Project Demo
-# 4. Collect all images (potato.png, tomato.png, etc.) and put in /images/
+# 2. Download face-api.min.js (v0.22.2) from:
+# https://cdn.jsdelivr.net/npm/[email protected]/dist/face-api.min.js
+
+# 3. Download the models folder from:
+# https://github.com/justadudewhohacks/face-api.js/tree/master/weights
+# Place the entire 'weights' folder in your project root and rename it to 'models'
+
+# 4. Collect all images (potato.png, tomato.png, etc.) and put in /images/
-# 2. Download face-api.min.js from CDN or GitHub releases and place in folder
-
-![Final](Add photo of final product here)
-*Explain the final build*
-# 3. Download face-api.js /models folder from official repo and place in folder
-
-### Project Demo
-# 4. Collect all images (potato.png, tomato.png, etc.) and put in /images/
+# 2. Download face-api.min.js (v0.22.2) from:
+# https://cdn.jsdelivr.net/npm/[email protected]/dist/face-api.min.js
+
+# 3. Download the models folder from:
+# https://github.com/justadudewhohacks/face-api.js/tree/master/weights
+# Place the entire 'weights' folder in your project root and rename it to 'models'
+
+# 4. Collect all images (potato.png, tomato.png, etc.) and put in /images/
+```
+# Run
+```bash
+# Serve locally! (choose one)
+python -m http.server 8000
+# or use VSCode Live Server, or 'http-server' if you use node/npm
+# Open http://localhost:8000/upload.html in your browser
+```
+# Project Documentation
+### Screenshots
-### Screenshots
+## Screenshots
-### Screenshots
+## Screenshots
+![Snippet of Uploading page](images/ss-upload.png)
+![Snippet after Uploading image](images/ss-pic-upload.png)
+![Snippet of Output page](images/ss-output.png)
+![Certificate generated](images/Certificate.png)
+
+# Project Demo
 # Video
-[Add your demo video link here]
-*Explain what the video demonstrates*
-
-# Additional Demos
-[Add any extra demo materials/links]
+[Drive link](https://drive.google.com/file/d/1sX8CidnZxZqFXOf_tAk_UBnlHtkjTS0t/view?usp=sharing)
+Video shows: Upload process, comic analysis, result page, voice roast, certificate download and sharing.
 
-## Team Contributions
-- [Name 1]: [Specific contributions]
-- [Name 2]: [Specific contributions]
-- [Name 3]: [Specific contributions]
+# Team Contributions
+- Yadu S Rajeev: JavaScript AI logic, comic theming, CSS artwork, README, roast content, bug testing
+- Vaishnav V Bishoy: UI/UX design, veggie array, certificate Canvas code, Image assets collection, roast content, bug testing
 
----
-Made with ❤️ at TinkerHub Useless Projects 
+  ---
+  Made with ❤️ at TinkerHub Useless Projects 
 
 ![Static Badge](https://img.shields.io/badge/TinkerHub-24?color=%23000000&link=https%3A%2F%2Fwww.tinkerhub.org%2F)
 ![Static Badge](https://img.shields.io/badge/UselessProjects--25-25?link=https%3A%2F%2Fwww.tinkerhub.org%2Fevents%2FQ2Q1TQKX6Q%2FUseless%2520Projects)
-
-
-
diff --git a/face-api.min.js b/face-api.min.js
diff --git a/images/Certificate.png b/images/Certificate.png
diff --git a/images/You_FaceToFruit_Certificate (1).png b/images/You_FaceToFruit_Certificate (1).png
diff --git a/images/You_FaceToFruit_Certificate.png b/images/You_FaceToFruit_Certificate.png
diff --git a/images/bg.jpg b/images/bg.jpg
diff --git a/images/bittergourd.png b/images/bittergourd.png
diff --git a/images/carrot.png b/images/carrot.png
diff --git a/images/cucumber.png b/images/cucumber.png
diff --git a/images/drumstick.png b/images/drumstick.png
diff --git a/images/egg.png b/images/egg.png
diff --git a/images/eggplant.png b/images/eggplant.png
diff --git a/images/jackfruit.png b/images/jackfruit.png
diff --git a/images/onion.png b/images/onion.png
diff --git a/images/pineapple.png b/images/pineapple.png
diff --git a/images/potato.png b/images/potato.png
diff --git a/images/pumpkin.png b/images/pumpkin.png
diff --git a/images/recording.mp4 b/images/recording.mp4
diff --git a/images/redchilli.png b/images/redchilli.png
diff --git a/images/ss-output.png b/images/ss-output.png
diff --git a/images/ss-pic-upload.png b/images/ss-pic-upload.png
diff --git a/images/ss-upload.png b/images/ss-upload.png
diff --git a/images/tomato.png b/images/tomato.png
diff --git a/images/watermelon.png b/images/watermelon.png