README.md

metadata

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.