Social Connectivity App

This repository contains the early planning and development for a social connectivity application. The goal is to help groups of friends coordinate activities using large language models (LLMs).

Purpose

The app will use LLM-powered recommendations so friends can quickly decide:

• What to do – generate ideas for entertainment, events, or local attractions.
• Where to eat – suggest restaurants or cuisines based on group preferences.
• When to meet – assist with finding the best times for everyone to hang out.
• How to explore – discover new adventures around the city.

By gathering group input and combining it with local data, the app aims to make social planning easier and more exciting.

Getting Started

The project is in its earliest stage, but we now have a small demo script to collect user accounts and chat preferences. Future updates will include instructions on:

1. Setting up the development environment.
2. Installing any dependencies.
3. Running the application or associated services.

Demo

You can try the demo by running python account_chat.py. The script will ask for your email and a username, then start a simple chat loop where you share your social preferences. Type quit to end the conversation.

Web Interface

A basic Flask app is included in webapp.py so you can test the chat in a browser. First install Flask:

pip install flask

Then start the server:

python webapp.py

Open http://localhost:5000 and register to begin chatting. Messages are echoed back just like in the command-line demo.

Contributing

We welcome contributions! Feel free to open issues or submit pull requests once the project roadmap is published. Please keep an eye on this repository for updates as we build out the foundation.

License

All contents of this repository are released under the MIT License unless otherwise noted.

Google Calendar Import

A basic script is provided in calendar/google_import.py for importing events from a Google Calendar. It uses a service account for authentication. To run it, install the Google API dependencies:

pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib

Then execute:

python calendar/google_import.py path/to/credentials.json your_calendar_id

The script prints upcoming events from the specified calendar. Adjust the --max-results flag to retrieve more or fewer events.