https://github.com/victorssuto/lunchatron
Ai powered tool created during conUHack, that allows user to scan food
https://github.com/victorssuto/lunchatron
ai api cloud hackaton js node python
Last synced: 10 months ago
JSON representation
Ai powered tool created during conUHack, that allows user to scan food
- Host: GitHub
- URL: https://github.com/victorssuto/lunchatron
- Owner: VictorSsuto
- Created: 2025-02-01T16:46:22.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-04T01:39:36.000Z (about 1 year ago)
- Last Synced: 2025-03-21T23:29:43.857Z (11 months ago)
- Topics: ai, api, cloud, hackaton, js, node, python
- Language: JavaScript
- Homepage:
- Size: 4.45 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AI-Powered Receipt Ingredient Detector
## Overview
This project is an AI-powered receipt scanner that detects ingredients from uploaded images and suggests meal ideas with recipe links. The system utilizes computer vision to recognize ingredients visually, without relying solely on text extraction.
This project was developed during **ConUHack IX**.
## Features
- Upload images of receipts or ingredients.
- AI detects ingredients visually and extracts text when necessary.
- Retrieve recipe suggestions based on detected ingredients.
- Integrated with Google Cloud Vision API for image processing.
## Demo
Watch the YouTube demo: [AI-Powered Receipt Scanner Demo](https://youtu.be/yrHQ3jAXDcE)
## Tech Stack
- **Frontend**: React (JavaScript/TypeScript)
- **Backend**: FastAPI (Python)
- **Cloud Services**: Google Cloud Vision API
- **Communication**: REST API
## Installation & Setup
### Prerequisites
Ensure you have the following installed:
- **Node.js** (for running the frontend)
- **Python 3.x** (for running the backend)
- **Google Cloud Vision API credentials**
### Backend (FastAPI)
1. Navigate to the backend directory:
```sh
cd backend
```
2. Install dependencies:
```sh
pip install -r requirements.txt
```
3. Start the FastAPI server:
```sh
uvicorn main:app --reload
```
### Frontend (React)
1. Navigate to the frontend directory:
```sh
cd frontend
```
2. Install dependencies:
```sh
npm install
```
3. Start the React development server:
```sh
npm start
```
4. Open the application in your browser at:
```
http://localhost:3000
```
## API Endpoints
| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `/upload` | Upload an image for ingredient detection |
| GET | `/ingredients` | Retrieve detected ingredients |
| GET | `/recipes?ingredients=...&meal_type=...` | Get meal ideas based on ingredients |
## Usage Restrictions
Please note that this project is not openly available for public use, as API calls to the Google Cloud Vision API incur significant costs. If you wish to use or test this project, please contact the developer.