Skip to content

PJ-impact/QuickCare-AI-USSD

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

This is a professional, high-impact README.md for the Audax Group. It is designed to impress hackathon judges by highlighting your technical stack, the social impact (SDG 3), and your clean, modular architecture.

Copy the block below and save it as README.md in your main project folder.


🏥 QuickCare: AI-Powered USSD Hospital Triage

A Solution by Audax Group Bridging the Healthcare "First Mile" in Ghana

QuickCare is a modular, AI-driven healthcare system designed to reduce hospital congestion and improve patient access in regions with limited internet connectivity. By combining USSD technology with Google Gemini 2.0 Flash AI, we provide a "Digital Front Door" to healthcare that works on any basic mobile phone.


🌍 The Problem: The "Queue Crisis"

In many public health facilities across Ghana, patients spend hours in physical queues just for basic registration or sorting.

  • The Internet Gap: Millions lack smartphones or affordable data, excluding them from modern health apps.
  • Staff Burnout: Front-desk staff are overwhelmed by manual registration and basic triage tasks.
  • SDG Target 3.8: To achieve Universal Health Coverage, we must provide accessible, effective healthcare for all, regardless of technology.

💡 The Solution

QuickCare digitizes the first 30 minutes of the hospital visit before the patient even arrives.

  • Accessible Interface: Works on any "feature phone" via USSD—no data required.
  • AI-Powered Triage: Uses Gemini 2.0 Flash to analyze symptoms and provide instant department recommendations.
  • Live Staff Dashboard: A real-time, role-based web portal for doctors and records officers to track the live queue.
  • Unique Token System: Generates IDs (e.g., QC-001) to ensure organized, fair patient flow.

🛠️ Technical Stack

We designed QuickCare with a Modular Micro-Monolith approach for professional scalability:

  • Backend: Python / Flask
  • AI Engine: Google Gemini 2.0 Flash (via google-genai)
  • USSD Gateway: Africa’s Talking API
  • Frontend: Bootstrap 5 (Responsive Dashboard)
  • Tunneling: Ngrok (Secure bridge for local development)

📁 Repository Structure

├── app.py           # Main Controller & Flask Routes
├── requirements.txt # Project Dependencies (flask, google-genai)
├── .gitignore       # Prevents uploading .venv and junk files
└── README.md        # Project Documentation & Story

📊 The "Audax" Impact (SDG 3)

By moving triage and registration to USSD, QuickCare directly contributes to Good Health and Well-being:

  1. Efficiency: Reduces physical wait times by an estimated 30%.
  2. Inclusivity: Ensures those without smartphones are not left behind.
  3. Data-Driven: Provides hospital admins with real-time data on queue volume and symptom trends.

Queue Wait-Time Logic

We provide patients with an estimated wait time ($W_{est}$) using a linear growth model: $$W_{est} = P_{ahead} \times T_{avg}$$ Where $P_{ahead}$ is the current queue length and $T_{avg}$ is the 10-minute triage average.


Built with ❤️ for the 2026 Hackathon Audax Group | Central University, Ghana

About

AI-powered hospital triage via USSD for low-connectivity regions (SDG 3).

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages