richardyeboah2023-tech/stempath-ai

AI Academic Advisor for African Students - Google Cloud Rapid Agent Hackathon 2026 # 🎓 STEMPath AI — Academic Advisor for African Students > **Google Cloud Rapid Agent Hackathon 2026** | MongoDB Partner Track > Built by a KNUST undergraduate (beginner programmer) with AI assistance --- ## 🎬 Demo 🌐 **🔥 Try Live App** 🎥 **Watch Demo Video on Loom** --- ## 🌟 What is STEMPath AI? **STEMPath AI** is an intelligent academic advisor for African university students, built on **Google Cloud Agent Builder** and powered by **Gemini 2.5 Flash**. It uses **MongoDB** for profile persistence and chat history. The agent uses real tool calling to: - Calculate CWA from course grades - Find matching scholarships - Generate personalized study plans --- ## 👨‍💻 My Honest Story I am **Richard Yeboah**, an undergraduate at **KNUST (Kwame Nkrumah University of Science and Technology)** in Ghana — and I'm a **beginner programmer**. I originally built a simple rule-based chatbot as a Python practice project. When the Google Cloud Rapid Agent Hackathon was announced, I saw an opportunity to evolve it into something real. ### What I Built Personally - ✅ The **idea and vision** (from my lived KNUST experience) - ✅ The **original rule-based chatbot** (intents2.json — 20+ categories) - ✅ **Ghana-specific knowledge** (CWA scale, local context) - ✅ **Feature design** and **architectural decisions** - ✅ **Testing, debugging, deployment** ### Where AI Tools Helped - 🤖 Google Cloud Agent Builder integration - 🤖 Tool calling architecture - 🤖 MongoDB persistence layer - 🤖 UI design and CSS styling - 🤖 Production code patterns I'm transparent about this because honesty matters more than appearing more experienced than I am. This is how beginners build in 2026 — using AI as a learning partner. --- ## 🔧 Required Tech Stack (All Runtime Invoked) | Technology | Role | File | |-----------|------|------| | **Google Gemini 2.5 Flash** | AI engine | `gemini_agent.py` | | **Google Cloud Agent Builder** | Agent orchestration | `agent_builder.py` | | **MongoDB (Partner MCP …