| --- |
| title: FInFront |
| emoji: 🚀 |
| colorFrom: red |
| colorTo: red |
| sdk: streamlit |
| app_port: 8501 |
| tags: |
| - streamlit |
| pinned: false |
| app_file: app.py |
| short_description: This is the frontend for project |
| license: mit |
| sdk_version: 1.49.1 |
| --- |
| |
| # FinFront |
| This was created to be a learning web platform for the Jamaican youth to understand financial literacy and numeracy. |
|
|
|
|
| 💡 Project: $mart Kids – AI Financial Literacy Platform |
|
|
| 🌍 Overview |
| $mart Kids is an AI-powered web-based learning platform designed to teach financial literacy through lessons, quizzes, and interactive games. |
| Built with Streamlit, FastAPI, LangGraph, TiDB Cloud, and Hugging Face models, it leverages multi-agent AI workflows and vector search to provide personalized tutoring experiences for students, while giving teachers tools to manage classes and track progress. |
|
|
| ❓ Problem & Solution |
| In Jamaica and many developing countries, students often lack engaging, accessible tools for learning financial literacy and numeracy. Traditional classrooms don’t adapt well to different learning paces, teachers struggle to track student progress at scale, and parents lack visibility. |
|
|
| **$mart Kids solves these challenges by:** |
| - Gamifying financial learning through XP and leaderboards. |
| - Offering a personalized AI tutor that adapts to each student. |
| - Providing teachers with dashboards, lesson creation tools, and real-time progress tracking. |
| - Allowing parents to receive detailed reports on student progress. |
|
|
|
|
| ✨ Features |
| Student Dashboard |
| Explore lessons, attempt quizzes (currently preloaded due to OSS constraints), receive AI tutor feedback, and play engaging games like Budget Builder and Debt Dilemma. |
|
|
| Teacher Dashboard |
| Create and manage lessons, assign quizzes, and track student performance with intuitive dashboards. |
|
|
| Gamified Learning |
| Earn XP, compete on leaderboards, and reinforce knowledge through play. |
|
|
| Powered by Modern Tech |
| Built with Streamlit (frontend), FastAPI + LangGraph (backend), and TiDB Cloud (database + vector search). |
|
|
| 🛠️ Tech Stack |
| Frontend: Streamlit (FinFront) |
| Backend: FastAPI + LangGraph (FinBack) |
| Database: TiDB Cloud (with Vector Search) |
| Models: Hugging Face (TinyLlama, E5 embeddings) |
| Deployment: Hugging Face Spaces |
|
|
|
|
| 🔄 Data Flow & Integration |
| 1. Student/Teacher Action → User interacts with FinFront (Streamlit). |
| 2. API Requests → FinFront communicates with FinBack (FastAPI). |
| 3. Database Operations → FinBack stores and retrieves lessons, quizzes, and user progress from TiDB Cloud. |
| 4. Vector Search → Lesson embeddings are stored in TiDB Cloud for semantic search and personalization. |
| 5. AI Models → Hugging Face models (TinyLlama for chat, E5 for embeddings) are used for tutoring, explanations, and adaptive learning. |
| 6. Feedback Loop → Results (XP, scores, progress) are sent back to dashboards in FinFront. |
|
|
| 🛠️ TiDB Cloud Account |
| Email: financialtidb@gmail.com |
| Database Name: fin_edu_agentic |
|
|
| 📹 Demo Video |
| 👉 https://youtu.be/jtVrZ_SKp4k |
| |
| |
| 🚀 Run Instructions |
| Access Online |
| 1. Open FinFront on Hugging Face - https://finedproj-finfront.hf.space/ |
| 2. Click the Welcome dropdown in the sidebar. |
| 3. Choose Sign Up as a Student or Teacher and complete the form. |
| This will take you to the login page where you can use the credentials that you just created or the pre-created ones below. |
| |
| Student |
| Username: tidbhack_student@email.com |
| Password: hacking2025 |
| |
| Teacher |
| Username: tidbhack_teacher@email.com |
| Password: hacking2025 |
| |
| 4. After signup: |
| Students → lessons, quizzes, games, AI tutor. |
| Teachers → lesson management, quiz tools, dashboards. |
| (Note: quizzes are currently preloaded due to limitations in open-source LLM quiz generation.) |
|
|
|
|
|
|
| 📜 License |
| MIT License |
|
|
| Copyright (c) 2025 lanna_lalala;-; |
| |
| Permission is hereby granted, free of charge, to any person obtaining a copy |
| of this software and associated documentation files (the "Software"), to deal |
| in the Software without restriction, including without limitation the rights |
| to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
| copies of the Software, and to permit persons to whom the Software is |
| furnished to do so, subject to the following conditions: |
| |
| The above copyright notice and this permission notice shall be included in all |
| copies or substantial portions of the Software. |
| |
| THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
| IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
| FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
| AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
| LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
| OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE |
| SOFTWARE. |
| |
