Project: Creative Apps - Coffee Finder

[joshua7736]

Track

Creative Apps (GitHub Copilot)

Project Name

Coffee Finder

GitHub Username

@joshua7736

Repository URL

https://github.com/joshua7736/coffee-finder

Project Description

Find nearby coffee shops and cafes from your current location, an address, or lat/lng coordinates. Coffee Finder supports three interfaces: a command-line tool, graphical desktop app, and a system tray icon. It uses OpenStreetMap Overpass API by default and optionally integrates with Google Places for enhanced ratings and reviews.

Demo Video or Screenshots

Screenshots: https://github.com/joshua7736/coffee-finder/tree/main/screenshots

Coffee Finder Copilot Usage Demo Screenshot.png

Coffee Finder CLI Demo Screenshot.png

Coffee Finder GUI Create Account Demo Screenshot.png

Coffee Finder GUI Login Demo Screenshot.png

Coffee Finder GUI Coffee Search Demo Screenshot.png

Coffee Finder GUI Saved Coffee Demo Screenshot.png

Primary Programming Language

Python

Key Technologies Used

Language: Python 3.8+

GUI: Tkinter

System Tray: pystray + Pillow

Database: SQLite via sqlite3

HTTP / APIs: requests (Nominatim / Overpass / ipinfo; optional Google Places)

Geocoding / Data Providers: OpenStreetMap Nominatim, Overpass API; optional Google Places API

Authentication / Crypto: SHA-256 hashing via hashlib

Caching / Persistence: Local SQLite cache and app DB

Testing: pytest

Packaging / CLI: pyproject.toml entry points, console scripts

Build / Distribution: PyInstaller

Dev tooling: git + GitHub (repository), CI-friendly pytest runs

Submission Type

Individual

Team Members

N/A

Submission Requirements

• My project meets the track-specific challenge requirements
• My repository includes a comprehensive README.md with setup instructions
• My code does not contain hardcoded API keys or secrets
• I have included demo materials (video or screenshots)
• My project is my own work with proper attribution for any third-party code
• I agree to the Code of Conduct
• I have read and agree to the Disclaimer
• My submission does NOT contain any confidential, proprietary, or sensitive information
• I confirm I have the rights to submit this content and grant the necessary licenses

Quick Setup Summary

1. Clone or download the project:
   cd /path/to/coffee-finder

2. Install dependencies:
   python -m pip install -r requirements.txt

3. (Optional) Install the package in editable mode for console commands:
   python -m pip install -e .

Technical Highlights

Made use of AI to create a working app that utilizes location search in a short timeframe.

Challenges & Learnings

My biggest challenge was having Copilot perform debugging based on prompts I issued, as the model would sometimes return a version of the app with the same issue, and no clear indicator of the cause.

Contact Information

joshua.ngui.classof2022@gmail.com | https://www.linkedin.com/in/joshua-ngui/

Country/Region

United States

[aycabas]

🎉 Thank you for your awesome submission!

We're happy to let you know that your Agents League - Creative Apps badge has been issued! 🏅

📧 Please check your email for the badge claim link.

Congratulations and thanks for being part of the community! 🚀