maxprodigy/Art-Nuggets-Implementation

This repository explores the application of LLMs to help Creatives learn about the Industry and learn about contracts, ultimately empowering African youth through technology and innovation. # Art Nuggets A Context-Aware Learning Recommender and Contract-Literacy Assistant for African Creative Entrepreneurs ## Overview Art Nuggets is a progressive web application (PWA) designed to support early-stage African creatives with two integrated capabilities: 1. A context-aware hybrid recommender system that provides personalized learning pathways. 2. A contract-literacy assistant that analyzes uploaded creative industry contracts and explains key clauses in plain English. The platform is optimized for low-bandwidth environments, mobile devices, and users with informal or fragmented learning journeys. It combines a modern front-end, a secure backend API, and a pluggable LLM pipeline for contract analysis. This repository contains the full implementation, including frontend, backend, database schema, and evaluation scripts. --- ## Table of Contents - Features - Architecture Overview - Prerequisites - Installation and Setup - 1. Clone Repository - 2. Backend Setup - 3. Database Setup (PostgreSQL) - 4. Frontend Setup - 5. Running Tests - Configuration - Usage Guide - Deployment Guide - Dataset and Model Information - Troubleshooting - Contribution Guidelines - License - Acknowledgements --- ## Features - Hybrid recommender system (content-based + collaborative signals) - Explainable contract analysis using large language models (LLMs) - Mobile-first progressive web app with offline caching - Secure authentication using JWT - Structured learning catalogue with tagging and filtering - Admin dashboard for content and user management - Full audit logging of user actions and model outputs - Modular architecture allowing pluggable AI models --- ## Project Links | Resource | Link | |-----------|------| | Report | here | | Demo Video | here | --- ## Architecture Overview The system consists of: - **Frontend (PWA):** React + Next.js, service workers for offline mode, IndexedDB for local caching. - **Backend API:** Node.js/Express (or FastAPI) handling use …