wesamly/libya-rag-kb

Libya Knowledge Base (RAG-Enabled) # Libya Knowledge Base (RAG-Enabled) A modern, AI-powered Knowledge Base application built with **Laravel 12**, **Vue.js 3**, and **Bootstrap 5**. This application serves as both a public-facing documentation site and a comprehensive admin panel for managing content and monitoring AI interactions. It is designed to work in tandem with a Python RAG (Retrieval-Augmented Generation) microservice to provide an intelligent chatbot assistant. ## Key Features ### Public Interface * **Full Vue 3 SPA:** The entire visitor experience (Home, Categories, Articles, Search) is a fast, interactive Single Page Application built with Vue 3. * **Interactive Chatbot:** Integrated floating chat component that queries a local LLM (via Python API) to answer user questions based on knowledge base content. * **Smart Search:** Full-text search capabilities with instant filtering. * **Responsive Design:** Built with Bootstrap 5.3 and custom CSS. ### Admin Dashboard (SPA) * **Dedicated Admin SPA:** A separate, protected Vue 3 application for administrators. * **Secure Authentication:** Powered by Laravel Sanctum (stateful cookie-based auth). * **Content Management:** Full CRUD for articles, and categories. * **Rich Text Editor:** Integrated Quill editor with automatic HTML sanitization (HTMLPurifier). * **RAG Monitoring:** * **Sync Status:** Track which articles need to be re-embedded. * **Chat History:** View full logs of user queries and AI responses. * **Content Gap:** Analyze unanswered questions to improve your KB. * **Pipeline Control:** Trigger Python ingestion scripts directly from the UI. --- ## Prerequisites * **PHP:** 8.4 * **Composer** * **Node.js** & **NPM** (Tested on 25.2.1 and 11.6.2 respectively) * **MySQL** (Primary Database, Tested on 8.0) * **Python Environment** (For the RAG microservice - see separate docs) --- ## Installation 1. **Clone the Repository** ```bash git clone github.com cd libya-rag-kb ``` 2. **Install PHP Depe …