BISHOP122222/Heritage-Nexus

A solution to the growing loss of African ancestral knowledge due to urbanization, generational shifts, and the absence of structured digital preservation systems. # Heritage Nexus Heritage Nexus is a comprehensive platform designed to help families preserve, explore, and connect with their ancestral lineage, traditions, and memories. Driven by an advanced AI assistant, the platform offers users deep insights into their family tree and cultural heritage. ## Architecture This project is built using a modern microservices-inspired architecture consisting of three main components: - `/frontend`: The React/Vite-based user interface for the Heritage Nexus platform. - `/backend`: The Node.js/Express backend server that handles data management, relationships, and user authentication using Prisma & PostgreSQL. - `/ai-service`: A FastAPI-powered Python microservice running a local large language model (Ollama) with Retrieval-Augmented Generation (RAG) and relationship reasoning engine to power the intelligent Heritage Family Advisor. ## Quick Start You can control the entire system from the root directory using the following commands: ### Install Dependencies To install all necessary dependencies for the frontend, backend, and the Python AI service: ```bash npm run install:all ``` *(Ensure you have Python, pip, Node.js, and Ollama installed on your system)* ### Development Mode Runs the frontend, the backend, and the AI microservice simultaneously: ```bash npm run dev ``` ### Individual Service Controls You can run individual parts of the system if you don't need the entire stack: - `npm run frontend`: Start only the React frontend server. - `npm run backend`: Start only the Node.js backend server. - `npm run ai` or `npm run dev:ai`: Start only the Python AI service. ## Core Features 1. **Interactive Family Tree**: Build and explore extensive family lineages. 2. **AI Lineage Assistant**: Chat directly with your family tree using natural language. Fast Streaming SSE responses powered by `llama3.2:1b`. 3. **Memory Vault**: Store and share family photos, stories, and historical documents. 4. **Tribal & Clan Database**: Maintain …