Project Info
Inspiration
The idea for Refrigerator Ramsay came from a common problem we all face: food waste. So many times, we forget about ingredients in the fridge, or we don't know how to use them, and they go bad. We wanted to create something that could help us not only use those ingredients but also inspire us to try new recipes and reduce food waste in the process.
What it does
Refrigerator Ramsay is an AI-powered kitchen assistant that helps users make the most of their groceries. You can take a picture of your fridge or pantry, and the AI will identify the ingredients. Then, it suggests recipes based on what you have. It also has an interactive voice feature, so you can ask for cooking tips or get help with recipes in real-time.
How we built it
We used Google Gemini AI for image recognition to identify ingredients from photos. and then, to come up with creative meal ideas. We also added Hume EVI, which is an emotionally intelligent voice AI, to make the experience more interactive. This lets users chat with the AI to get tips, learn new cooking techniques, or personalize recipes.
Challenges we ran into
One challenge we faced was working with Hume EVI for the first time. It was really fun to explore, but there was definitely a learning curve. We had to figure out how to make the voice assistant not just smart but also engaging, making sure it could deliver cooking tips naturally and understand what users were asking. It took some trial and error to get the right balance between information and interaction. Another challenge was training the Google Gemini AI to be as accurate as possible when recognizing ingredients. It wasn't easy to ensure the AI could reliably detect different foods, especially when items were stacked or grouped together in photos. We had to spend extra time fine-tuning the model so that it could handle a variety of lighting conditions and product packaging.
Accomplishments we're proud of
We're proud of creating a solution that not only helps reduce food waste but also makes cooking more fun. The AI's ability to suggest creative recipes from random ingredients is really exciting. We're also proud of how user-friendly (and funny) the voice assistant turned out to be, making it feel like you're cooking with a friend.
What we learned
We learned a lot about how AI can be used to solve everyday problems, like reducing food waste. Working with Hume EVI taught us about building conversational AI, which was new for us. It was really fun, but there was definitely a challenge in figuring out how to make the voice interaction feel natural and helpful at the same time. We also learned about the importance of training AI models, especially with the Gemini AI. Getting the image recognition to accurately identify different ingredients required us to experiment a lot with the data and train the model to work in a variety of environments. This taught us that accuracy is key when it comes to creating a seamless user experience.
What's next
Next, we want to improve the AI’s ability to recognize even more ingredients and maybe even offer nutritional advice. We’re also thinking about adding features where the AI can help you plan meals for the whole week based on what you have. Eventually, we’d love to partner with grocery stores to suggest recipes based on store deals, helping users save money too!
Analysis
View
Metric
- 15
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- CSSIn code
- FastAPIIn code
- HTMLIn code
- JavaScriptIn code
- Next.jsIn code
- PythonIn code
- ReactIn code
- Tailwind CSSIn code
- TypeScriptIn code
9 of 9 appear in the indexed code.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
194 KB
Source files
41
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
sherwinvishesh/Refrigerator-Ramsay
64 files · 3.1 MB · @ 9d49420
Structure
Interface
21 files · 33%Screens, components and styles rendered to the user.
Application logic
14 files · 22%Domain rules, services and shared utilities.
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here — open the file browser to check anything the diagram implies.
Languages
- YAML67%
- TypeScript15%
- JavaScript14%
- Python2%
- CSS1%
- HTML1%
- Other (1)1%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
evi-files/package.json
npm · 28- @humeai/voice-react
- @radix-ui/react-slot
- @radix-ui/react-switch
- @radix-ui/react-toggle
- @types/react-virtualized
- class-variance-authority
- clsx
- framer-motion
- geist
- hume
- lucide-react
- next
- react
- react-dom
- react-virtualized
- remeda
- server-only
- tailwind-merge
- +10 more
frontend/package.json
npm · 15- @fortawesome/free-solid-svg-icons
- @fortawesome/react-fontawesome
- @testing-library/jest-dom
- @testing-library/react
- @testing-library/user-event
- react
- react-dom
- react-dropzone
- react-markdown
- react-router-dom
- react-scripts
- react-webcam
- rehype-raw
- styled-components
- web-vitals
backend/requirements.txt
pypi · 7- fastapi
- google-generativeai
- markdown
- Pillow
- python-dotenv
- python-multipart
- uvicorn
Declared in the repository’s manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
Feature verification
AI recipe generation from identified ingredientsVerified
It suggests recipes based on what you have
Claimed on Devposthigh confidencebackend/main.py:72— Second Gemini call (gemini-1.5-pro) generates a recipe from the identified groceries and user description, returned to the frontendfrontend/src/components/ChefChat.js:13— ChefChat page renders the returned recipe and groceries as Markdown
FastAPI backendVerified
Built with fastapi
Claimed on Devposthigh confidencebackend/main.py:2— FastAPI app defined with CORS middleware and a POST endpoint
Ingredient recognition from fridge/pantry photo via Google GeminiVerified
Take a picture of your fridge or pantry, and the AI will identify the ingredients
Claimed on Devposthigh confidencebackend/main.py:39— /analyze_image endpoint accepts an uploaded image and calls genai.GenerativeModel('gemini-1.5-flash').generate_content to identify groceriesfrontend/src/components/EntryDescription.js:51— Frontend uploads the image file via FormData to the backend /analyze_image endpoint
React frontendVerified
Built with react
Claimed on Devposthigh confidencefrontend/src/App.js:1— React app with react-router-dom routes for HomePage, EntryDescription, ChefChat, CallPage
Interactive voice feature via Hume EVI for cooking tips/help in real-timeCode-supported
It also has an interactive voice feature, so you can ask for cooking tips or get help with recipes in real-time
Claimed on Devpostmedium confidenceevi-files/utils/getHumeAccessToken.ts:5— Fetches a Hume access token via the hume SDKevi-files/components/Chat.tsx:26— Wraps chat UI in Hume's VoiceProvider from @humeai/voice-react, wiring up the voice sessionfrontend/src/components/CallPage.js:15— Main React app only embeds the EVI voice UI via an iframe pointing to an external deployed URL (refrigerator-ramsay-evi.vercel.app) rather than including the evi-files code directly, so end-to-end integration within this repo can't be fully confirmed
Nutritional advice / weekly meal planning / grocery store deal integration (future work)Claimed only
Next, we want to improve the AI's ability to recognize even more ingredients and maybe even offer nutritional advice... plan meals for the whole week... partner with grocery stores
Claimed on Devposthigh confidencePersonalized, data-driven meal suggestions learning from user history/preferencesClaimed only
The AI learns from your ingredient usage patterns, preferences, and cooking history, offering personalized meal suggestions
Claimed on readmehigh confidence
An AI agent derived these features from the project’s Devpost page and readme, then searched the code for each one. Verified features are backed by cited code; claimed-only features had no supporting code, which is not by itself proof a feature is missing.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.