Project Info

EasyDentistry

Inspiration

One of our teammates struggled to find an ideal dentist. She had to jump between multiple webpages — insurance portals, Google Maps, Yelp, etc. — just to make a decision.

What it does

Our framework follows a 3-step flow: Information Gathering — via APIs and user input Filtering — generate a shortlist of suitable dentists Conversational Recommendation — use an LLM-powered chatbot for personalized suggestions 📍 Outputs a List of Dentists Based on User Input: Location, Type of dental service, Preferred distance range ✨ Each Dentist Entry Includes: Dentist/Dental business name, Ratings, Clinic location, Contact information, Distance from user, Interior image of the clinic, Embedded Google Map, Link to view the map in full

Challenges we ran into

Expired API keys from earlier development Difficulty linking frontend and backend components

Accomplishments we're proud of

Identifying a real, relatable need from personal experience Getting hands-on with Cursor, Create.xyz, and WordExpress for building websites and chatbots

What's next

Make the chatbot smarter — ask more personalized, qualitative questions like “Are you anxious about dental visits?” or “Do you care more about gentleness or speed?” Add a text-to-voice feature to improve accessibility for broader audiences, supporting inclusivity and social justice Extend this idea in more physical and mental health application use cases

Personal Dentist Selection Tool

This project is a {Personal Dentist Selection Toolkit} that support physical well-being with accessible services. With information gathering and chatbot functions, users can make decision on selection and appointment of dentist easier, saving their time on selecting suitable dentist and enhance experience.

Demo Video

Watch the demo video

Interface & Example

Features

📍 Output a list of dentists based on your input:

Your location
Type of dental service
Preferred distance range

✨ Each dentist section includes:

Dentist name
Ratings
Clinic location
Contact information
Distance from your location
Interior image of the clinic
Embedded Google Map
Link to view the map in detail

Installation & Setup

Follow these steps to get the project running locally:

Clone the repository

git clone https://github.com/Yingxuan-Selina-Bian/CruzHacksDentist.git
cd CruzHacksDentist

Create and activate a virtual environment

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install the required packages

pip install -r requirements.txt

Set up environment variables: Create a .env file in the root directory and add your Gemini API key:

touch .env

Then edit .env and add your API keys.

License

This project is licensed under the Non-Commercial Public License (NCPL). This means:

✅ You can:

Use this software for personal purposes
Modify the software
Share the software with others
Contribute to the project

❌ You cannot:

Use this software for commercial purposes
Sell this software or any modifications of it
Remove or modify this license notice
All API keys and services used in this project require separate licenses and terms of service agreements.

Analysis

Compare with all teams

View

Metric

Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.

Technology

Found in codeClaimed only

CSSIn code
JavaScriptIn code
Next.jsIn code
ReactIn code
Tailwind CSSIn code
Google GeminiClaimed

5 of 6 appear in the indexed code. 1 claimed on Devpost could not be matched to code, which may simply mean the tool leaves no trace in the repository.

AI coding agents

No AI coding agent signals were found in this repository.

Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.

Codebase size

Source size

126 KB

Source files

Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.