Skip to content

FarazRahimi/Livi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🏠 Livi – Smart Roommate Matching for Students

Livi is an open-source web app built by and for students in the LACCD (Los Angeles Community College District). It helps users find compatible roommates based on lifestyle preferences, budget, and proximity to campuses.

πŸš€ Whether you're looking to share rent near your college or want to list a room, Livi is here to make the student housing experience easier, safer, and smarter.


🌟 Features

  • βœ… Match with compatible roommates using lifestyle criteria (sleep habits, cooking, cleanliness, etc.)
  • 🧭 Match based on proximity to any LACCD college using smart location scoring
  • 🏠 Landlords can post listings, and students can browse & apply
  • πŸ“¬ In-app messaging between matched roommates
  • πŸ”’ Secure login system with role-based portals for students and landlords
  • πŸ–₯️ Clean UI built with Bootstrap + Flask backend
  • πŸ’» Easily customizable and extendable (written fully in Python!)

πŸ“Έ Demo Preview

Livi Demo Home Page


πŸ› οΈ Installation

πŸ”§ Prerequisites

  • Python 3.8 or newer
  • pip package manager

βš™οΈ Setup Instructions

git clone https://github.com/farazrahimi/livi.git
cd livi-roommate-app

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Set up the Flask app
export FLASK_APP=app.py
export FLASK_ENV=development  # Optional: enables hot-reloading

# Run the app
flask run

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published