{"id":25869485,"url":"https://github.com/monnus/labellens","last_synced_at":"2026-05-02T18:40:30.578Z","repository":{"id":278565290,"uuid":"936034141","full_name":"Monnus/LabelLens","owner":"Monnus","description":"This LabelLens focuses on detecting product labels from uploaded images to assist with inventory management. ","archived":false,"fork":false,"pushed_at":"2025-04-24T10:26:25.000Z","size":577,"stargazers_count":0,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-24T11:32:02.649Z","etag":null,"topics":["amplify","aws","cognito","dynamodb","rekognition","s3-storage"],"latest_commit_sha":null,"homepage":"https://main.d3597sr9908kji.amplifyapp.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Monnus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-20T12:25:49.000Z","updated_at":"2025-04-24T10:26:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"d96c912a-8274-4de5-a5a9-37e6b016fc2d","html_url":"https://github.com/Monnus/LabelLens","commit_stats":null,"previous_names":["monnus/labellens"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Monnus/LabelLens","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Monnus%2FLabelLens","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Monnus%2FLabelLens/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Monnus%2FLabelLens/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Monnus%2FLabelLens/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Monnus","download_url":"https://codeload.github.com/Monnus/LabelLens/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Monnus%2FLabelLens/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263335804,"owners_count":23450933,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amplify","aws","cognito","dynamodb","rekognition","s3-storage"],"created_at":"2025-03-02T05:17:34.062Z","updated_at":"2026-05-02T18:40:30.540Z","avatar_url":"https://github.com/Monnus.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# 📸 LabelLens – Product Label Recognition App\n![image diagram of labellenz](./public/AWS%20image%20label%20Diagram.png)\n\n**LabelLens** is a **serverless image recognition** web application built using **AWS Rekognition**. It helps users identify product labels from uploaded images, making it perfect for **inventory management** or **cataloging** tasks. The app supports both **authenticated** and **unauthenticated** users—unauthenticated users can instantly upload and analyze images, while authenticated users can access **history tracking** for all their uploads.\n\n---\n\n## 🚀 Features\n\n- **🖼 Image Upload:** Upload product images directly from the web interface.\n- **🏷 AWS Rekognition Integration:** Automatically detects product labels and objects.\n- **💾 DynamoDB Storage:** Stores image data, labels, and metadata for authenticated users.\n- **🔐 Cognito Authentication:** Optional user authentication to enable history tracking.\n- **⚡️ Serverless Architecture:** Built using AWS services to ensure scalability and cost-efficiency.\n\n---\n\n## 📐 Architecture Overview\n\nThe project leverages AWS **serverless** services:\n\n- **S3 Bucket** – For storing uploaded images.  \n- **API Gateway** – Acts as a bridge between the front end and backend (Lambda functions).  \n- **Lambda Functions** – Handles image processing with Rekognition and database storage.  \n- **AWS Rekognition** – Detects labels from uploaded images.  \n- **DynamoDB** – Stores image metadata and recognition results.  \n- **Cognito** – Manages user authentication (sign-in/sign-up).  \n- **Amplify** – Hosts and manages the front end.\n\n---\n\n## 🛠 Tech Stack\n\n- **Frontend:** React.js (using AWS Amplify \u0026 Amplify UI components)  \n- **Backend:** AWS Lambda (Node.js 20.x runtime)  \n- **Authentication:** AWS Cognito  \n- **Storage:** Amazon S3 \u0026 DynamoDB  \n- **Image Recognition:** AWS Rekognition  \n- **Hosting:** AWS Amplify Hosting  \n- **API Gateway:** REST API for Lambda integration  \n\n---\n\n## ⚙️ Setup Guide\n\nFollow these steps to replicate or deploy **LabelLens**:\n\n---\n\n### 1️⃣ AWS S3 – **Image Storage**\n\n1. **Create an S3 Bucket** named:  \n   `image-rekognition-bucket*****-dev`\n2. Enable **public access** for uploaded files.\n3. Define two folders inside the bucket:  \n   - `/uploads/unath` – For uploaded images  \n   - `/uploads/auth` – (optional) For auth users\n\n4. Add the following **S3 bucket policy** to allow Lambda to access images:\n\n```json\n{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Sid\": \"AllowLambdaS3Access\",\n      \"Effect\": \"Allow\",\n      \"Principal\": \"*\",\n      \"Action\": [\"s3:GetObject\", \"s3:PutObject\"],\n      \"Resource\": \"\u003cbucketName/\u003e\"\n    }\n  ]\n}\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonnus%2Flabellens","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmonnus%2Flabellens","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonnus%2Flabellens/lists"}