Skip to content

luacantu/miacompasshub

Repository files navigation

GHBanner

Run and deploy your AI Studio app

This contains everything you need to run your app locally.

View your app in AI Studio: https://ai.studio/apps/1466c577-ef71-4482-87fc-485ccce9fbd3

🧭 MIACompass Hub

Miami's AI-Powered Community Resource Navigator


🌐 Live App

[miacompass.com]


💡 What It Does

MIACompass Hub connects Miami-Dade residents with free housing, food, healthcare, jobs, education, and transit support — in English and Spanish, powered by AI.

Most people don't know what resources exist. And even when they do, the stress of daily survival makes it impossible to find them. MIACompass Hub bridges that gap.


🤖 How It Works

A 5-step survey collects the user's situation. Then 4 specialized AI agents work together to find and deliver a personalized resource plan:

User Survey ↓ 📋 Intake Agent ↓ 🔍 Research Agent
↓ ✅ Eligibility Agent ↓ 📄 Action Plan Agent ↓ 💼 Jobs

✨ Features

  • 5-step onboarding survey — employment, housing,health, needs, location, urgency
  • Personalized resource plan — 3-tier structure, real programs, real phone numbers
  • Live job listings — Miami-Dade jobs matched to user profile
  • Transit Hub — Google Maps trip planner to any resource location
  • Ask Compass — follow-up chat that remembers your full profile
  • EduGrants Hub — Florida, Miami-Dade & Broward grants, scholarships, FAFSA support, college options
  • My Plan — save programs, jobs, action steps
  • Fully bilingual — English & Spanish, auto-detected from survey
  • Urgency detection — crisis resources surface first
  • Mobile responsive — works on any device

🛠️ Tech Stack

Layer Technology
AI Agents Google ADK (Agent Development Kit)
AI Model Gemini 2.5 Flash
Web Search Gemini Grounding + Google Search Tool
Backend Python + Flask
Frontend Vanilla JS + HTML/CSS
Auth Firebase Authentication
Persistence localStorage + Firebase Firestore
Deployment Google Cloud Platform

``'

🏆 Built At

DeepStation Google Hackathon 2026 Hosted by DeepStation, Miami Dade College & The LAB Miami

March 20-21, 2026 · Miami, Florida

Hackathon Theme: Use AI to make your community work better for the people in it.

Stack used: Google ADK · Gemini API · Google AI Studio

Judge criteria met:

  • ✅ AI that takes action — not just answers
  • ✅ Uses real data and live web grounding
  • ✅ Solves a real problem end to end
  • ✅ Multi-agent system (advanced tier)
  • ✅ Community theme — Miami-Dade residents

🌎 The Story

MIACompass Hub was born from personal experience.

In 2012, the founder was a dv survivor who was evicted and left with her daughter and nothing. Resources existed housing help, food assistance, legal aid but the stress of survival, language barriers, and scattered information made them impossible to find.

15 years later, as a developer and builder in Miami's tech community, she built MIACompass Hub at a hackathon because no one in her community should ever have to search alone.


📞 Emergency Resources

🚨 Emergency 911
📞 Crisis & Resources 211
🧠 Mental Health 988
💜 Domestic Violence 1-800-500-1119

👩‍💻 Built By

Luana Cantuarias Founder · Developer · Miami


MIACompass Hub — Miami has resources for you. Let's find them together. 🧭

About

MIACompass Hub connects Miami-Dade residents with free housing, food, healthcare, jobs, education, and transit support in English and Spanish, powered by Gemini.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors