glasshome-matching-colivers

What is it

Matchmaking app to find your best fit for your neighbours, flatmates in a community living set up.

Discover Yourself. Connect with Others. Unlock deeper insights about your personality, values, and preferences, and find your perfect community match.

How to use repository

1. Go to the desired folder you want to save the repository

2. Clone the repository:

   git clone https://github.com/alejandranavcas/glasshome-matching-colivers.git
   cd glasshome-matching-colivers

3. Create and activate virtual environment:

   # Replace python3.10 with the full path if needed
    python3.10 -m venv .venv

   # Windows
   .venv\Scripts\activate
   
   # macOS/Linux
   source .venv/bin/activate

4. Install dependencies:

   If you only want to run the working app:

   # Install only app dependencies
   pip install -r app/requirements.txt

   Or, if you want to use also the experiments folder then:

   # Install all repository dependencies
   pip install -r requirements.txt

Run the streamlit app

1. Activate the virtual environment (if not already active):

   # Windows
   .venv\Scripts\activate
   
   # macOS/Linux
   source .venv/bin/activate

2. Navigate to the app folder and run Streamlit:

   cd app
   streamlit run app.py

The app will open automatically in your default browser at http://localhost:8501. If it doesn't, manually navigate to that URL.

Optional: Save data to Postgres (Render)

By default, survey answers are saved to CSV files in data/. The app can also mirror each saved row into Postgres.

1. Provision a PostgreSQL database (for example on Render).
2. Add one of these environment variables to your app service:
   • DATABASE_URL (preferred)
   • RENDER_POSTGRES_URL
   • POSTGRES_URL
3. Redeploy the app.

When one of those variables is present, new rows continue to be written to CSV and are also inserted into Postgres tables:

• saved_answers_demographics
• saved_answers_practical
• saved_answers_lifestyle
• saved_answers_personality
• saved_answers_personality_responses
• saved_answers_values
• saved_user_credentials