🛡️ RentLens

AI-Powered Housing Rights Advocate

Live Demo • Report Bug

📖 About The Project

RentLens is a web application that empowers tenants to identify potential lease violations, understand their rights, and take informed action. Take a photo. Know your rights. Get justice.

Housing disputes can be overwhelming. RentLens bridges the gap by using AI to analyze evidence and provide instant legal context. Users can upload photos of issues like mold, pests, or damage, and our platform generates a detailed report including applicable local laws, recommended actions, and even a draft message to their landlord.

📸 Interface

Modern Landing Page

Smart Signup & Analysis

✨ Key Features

• 📸 AI-Powered Analysis – Uses Gemini Multimodal capabilities to analyze images and text descriptions of housing issues
• 📍 Location-Aware Justice – Leverages user location to cite specific, relevant local housing laws and ordinances
• 📑 Comprehensive Reporting – Generates detailed reports covering tenant rights, legal citations, and next steps
• ✉️ Automated Drafts – Creates pre-written, professional messages for users to send to their landlords
• ⚖️ Legal Aid Locator – Identifies and displays nearby legal aid clinics on a map
• 📱 Streamlined Interface – Intuitive, step-by-step form for uploading evidence and describing problems

🛠️ Built With

Frontend

Backend & Services

APIs

– Multimodal analysis and report generation
– Location services and legal aid discovery

🚀 Getting Started

Installation

1. Clone the repository

   clone this repository
   cd RentLens

2. Install dependencies

   Backend:

   cd backend
   npm install

   Frontend:

   cd ../frontend
   npm install

3. Set up environment variables

   Create a .env file in the backend directory:

   PORT=5001
   GEMINI_API_KEY=your_gemini_api_key_here
   GEMINI_MODEL=gemini-2.0-flash
   GOOGLE_PLACES_API_KEY=your_google_places_api_key_here

   Create a .env file in the frontend directory:

   VITE_API_URL=http://localhost:5001
   VITE_GOOGLE_MAPS_API_KEY=your_google_maps_api_key_here

   Note: You'll need to obtain API keys from:

   • Google AI Studio (for Gemini)
   • Google Cloud Console (for Google Maps & Places APIs)

4. Start the development server

   Terminal 1 (Backend):

   cd backend
   node index.js

   Terminal 2 (Frontend):

   cd frontend
   npm run dev

5. Open your browser

   Navigate to: http://localhost:5173

---

💡 Usage

1. Upload Evidence – Take or upload photos of the housing issue (mold, leaks, damage)
2. Add Details – Provide a brief written description of the problem history
3. Set Location – Input your address or auto-detect location to find relevant laws
4. Run Scan – RentLens sends the data to Gemini AI for analysis
5. View Report – Review your rights, cited laws, and recommended next steps
6. Take Action – Use the auto-generated email draft or find a local legal clinic

Developed by:

• TEAM CKC

📄 License

Distributed under the MIT License. See LICENSE for more information.

🙏 Acknowledgments

• Google AI Studio for the Gemini API
• Google Maps Platform for location services

⬆ Back to Top