Skip to content

Varshinigurram/neighborloop-ai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌱 NeighborLoop – AI-Powered Sustainable Surplus Sharing App

💡 Built using Google Cloud AI + Database integration to demonstrate real-world Generative AI applications. Python Flask GCP Gemini AlloyDB

NeighborLoop is an AI-powered web application that enables intelligent surplus sharing within a community. It integrates Gemini 3 Flash with AlloyDB AI to analyze items, generate natural language descriptions, and enable semantic search directly within the database.

This project was implemented as part of the Google Cloud Codelab: Gemini 3 Flash + AlloyDB Sustainability App and deployed using Google Cloud services.


🔗 Live Demo

👉 https://neighbor-loop-5808901341.us-central1.run.app

⚠️ Note: This deployment may be disabled to avoid continuous cloud charges (especially AlloyDB). The application can be redeployed anytime.


🚀 Overview

NeighborLoop is designed as a swipe-style surplus-sharing platform where users can explore items shared within a community.

Instead of relying on manual descriptions or keyword-based search, the system uses AI to:

  • Understand item images and text
  • Automatically generate meaningful descriptions
  • Enable semantic, context-aware discovery

✨ Features

  • 🧠 AI-Generated Descriptions Gemini analyzes images and produces human-like descriptions

  • 🔍 Semantic Search Finds relevant items based on meaning rather than exact keywords

  • 🗄️ AlloyDB AI Integration Embeddings and vector operations executed directly inside the database

  • 📸 Multimodal Processing Combines image and text understanding

  • ☁️ Cloud-Native Deployment Built and deployed using Google Cloud (Cloud Shell + managed Cloud Run)

  • 💡 Interactive UI Swipe-inspired interface for exploring items


🛠️ Tech Stack

Frontend

  • HTML, CSS (Templates)

Backend

  • Python (Flask)

Database

  • AlloyDB (PostgreSQL with vector extensions)

AI

  • Gemini 3 Flash API
  • Text Embeddings (text-embedding-005)

Cloud

  • Google Cloud Platform (GCP)
  • Cloud Shell (Development Environment)
  • Cloud Run (Managed Deployment)
  • Cloud Storage (Image Handling)

🧠 How It Works

  1. Items (with images) are uploaded or displayed

  2. Images are stored in Cloud Storage

  3. Gemini API:

    • Analyzes images
    • Generates descriptive text
  4. AlloyDB:

    • Stores structured data
    • Generates embeddings within SQL
  5. Semantic queries retrieve similar items based on meaning

  6. Results are presented through a simple UI


🏗️ Architecture

  • Gemini 3 Flash → Multimodal AI reasoning
  • AlloyDB AI → Vector storage + semantic querying
  • Cloud Storage → Image storage
  • Flask Backend → Application logic
  • Cloud Run → Managed deployment service

📂 Project Structure

├── templates/          # Frontend templates
├── app.py              # Flask application
├── requirements.txt    # Dependencies
├── README.md           # Documentation
└── .gitignore

☁️ Deployment

This application was deployed using Google Cloud Shell and integrated Google Cloud services.

Steps Performed:

  • Enabled required GCP APIs
  • Created and configured AlloyDB instance
  • Set up Cloud Storage bucket
  • Configured environment variables in Cloud Shell
  • Ran and tested the application in cloud environment
  • Deployed and accessed the application via Cloud Run service URL

⚠️ Note: Deployment followed the guided setup from the Google Cloud Codelab, focusing on integration of services rather than manual infrastructure or DevOps pipeline configuration.


📸 Demo

Screenshot 2026-03-22 002604

👩‍💻 My Contributions

  • Configured Google Cloud environment and enabled required APIs
  • Set up and connected AlloyDB instance
  • Integrated Gemini 3 Flash API for AI-generated descriptions
  • Worked with and configured a Flask-based backend application
  • Configured Cloud Storage for image handling
  • Deployed and tested the application using Cloud Shell and Cloud Run

📌 Key Learnings

  • Integrating Generative AI with databases
  • Using Gemini for multimodal AI applications
  • Implementing semantic search using embeddings
  • Working with AlloyDB AI capabilities
  • Deploying applications using Cloud Run and Cloud Shell

🎯 Why This Project Matters

This project demonstrates how modern applications can combine:

  • Generative AI (Gemini)
  • Vector databases (AlloyDB AI)
  • Cloud-native deployment (GCP)

to build intelligent, scalable, and real-world solutions.

⚠️ Note

This project is based on a Google Cloud Codelab and demonstrates real-world integration of AI with cloud-native databases and services.


🔮 Future Improvements

  • User authentication system
  • Personalized recommendations
  • Improved UI/UX
  • Mobile responsiveness

📜 License

Apache 2.0 License


👩‍💻 Author

Varshini Gurram AI | Cloud | Data Enthusiast Building intelligent and scalable applications


⭐ Support

If you found this project useful, consider giving it a ⭐ on GitHub!

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors