README.md

---
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.