grok client setup

.env

@@ -0,0 +1,26 @@
+# OPENAI_API_KEY=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
+OPENROUTER_API_KEY=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
+TEMPERATURE=0.8
+MAX_TOKENS=2000
+RETRIEVE_K=5
+TOP_P=0.9
+MAX_CONVERSATION_HISTORY = 5
+MODEL=deepseek/deepseek-r1-0528-qwen3-8b:free
+BASE_URL=https://openrouter.ai/api/v1
+#openai/o4-mini-high openai/gpt-oss-20b:free meta-llama/llama-3.2-11b-vision-instruct:free 
+#deepseek/deepseek-r1-0528-qwen3-8b:free 
+
+#GROQ
+GROQ_API_KEY=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
+G_TEMPERATURE = 0.7
+G_MAX_CONVERSATION_HISTORY = 5
+G_MODEL = compound-beta-mini  
+G_MODEL1 = compound-beta
+G_TOP_P = 0.7
+G_MAX_TOKENS = 2000
+G_RETRIEVE_K = 8
+MMR = mmr
+G_FETCH_K = 20
+LAMBDA_MULT = 0.5
+
+

Dockerfile

@@ -1,16 +1,27 @@
-# Read the doc: https://huggingface.co/docs/hub/spaces-sdks-docker
-# you will also find guides on how best to write your Dockerfile
+# 1. Use even smaller base image
+FROM python:3.11-slim AS base
 
-FROM python:3.9
+# 2. Set working directory
+WORKDIR /app
 
-RUN useradd -m -u 1000 user
-USER user
-ENV PATH="/home/user/.local/bin:$PATH"
+# 3. Install only essential system dependencies
+#    --no-install-recommends avoids extra packages
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends gcc libpq-dev && \
+    rm -rf /var/lib/apt/lists/*
 
-WORKDIR /app
+# 4. Copy requirements first for caching
+COPY requirements.txt .
+
+# 5. Upgrade pip & install Python deps with no cache
+RUN python -m pip install --upgrade pip \
+    && pip install --no-cache-dir -r requirements.txt
+
+# 6. Copy app code
+COPY . .
 
-COPY --chown=user ./requirements.txt requirements.txt
-RUN pip install --no-cache-dir --upgrade -r requirements.txt
+# 7. Expose default FastAPI port (Uvicorn)
+EXPOSE 8000
 
-COPY --chown=user . /app
-CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "7860"]
+# 8. Run Uvicorn directly (better than python main.py)
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000", "--workers", "1"]

clients/groq_client.py

@@ -0,0 +1,341 @@
+# clients/groq_client.py
+
+import os
+import json
+from uuid import uuid4
+from groq import Groq
+from langchain_core.documents import Document
+from langchain_huggingface import HuggingFaceEmbeddings
+from langchain_chroma import Chroma
+from dotenv import load_dotenv
+import random
+import shutil
+from optimized_quiz import OPTIMIZED_QUESTIONS
+
+load_dotenv()  # load .env variables from root
+
+# Config
+GROQ_API_KEY = os.getenv("GROQ_API_KEY")
+DATA_PATH = "data.json"  # relative to root, so this works if run from root
+CHROMA_PATH = "chroma_db"
+
+TEMPERATURE = float(os.getenv("G_TEMPERATURE", 0.7))
+MAX_TOKENS = int(os.getenv("G_MAX_TOKENS", 400))
+RETRIEVE_K = int(os.getenv("G_RETRIEVE_K", 3))
+TOP_P = float(os.getenv("G_TOP_P", 1.0))
+MAX_CONVERSATION_HISTORY = int(os.getenv("G_MAX_CONVERSATION_HISTORY", 5))
+MMR = str(os.getenv("MMR", "mmr"))
+G_FETCH_K = int(os.getenv("G_FETCH_K", 20))
+LAMBDA_MULT = float(os.getenv("LAMBDA_MULT", 0.5))
+# Read environment variables with defaults
+model_1 = os.getenv("G_MODEL", "compound-beta")
+model_2 = os.getenv("G_MODEL1", "compound-beta-mini")
+
+
+class GroqClient:
+    def __init__(self):
+        self.conversation_history = []
+
+        self.documents = self.load_json_data(DATA_PATH)
+        if not self.documents:
+            raise RuntimeError("No data loaded")
+
+        self.vector_store = self.init_vector_store(self.documents)
+        # self.retriever = self.vector_store.as_retriever(
+        #     search_type="similarity", search_kwargs={"k": RETRIEVE_K}
+        # )
+
+        self.retriever = self.vector_store.as_retriever(
+            search_type=MMR,  # Use Maximal Marginal Relevance
+            search_kwargs={
+                "k": RETRIEVE_K,  # Final number of docs to return
+                "fetch_k": G_FETCH_K,  # Number of docs to initially fetch before filtering for diversity
+                "lambda_mult": LAMBDA_MULT,  # Balance between relevance (1.0) and diversity (0.0)
+            },
+        )
+
+        if not GROQ_API_KEY:
+            raise RuntimeError("GROQ_API_KEY not found in environment")
+
+        self.client = Groq(api_key=GROQ_API_KEY)
+
+        self.SYSTEM_MESSSAGE = (
+            "You are Moses's AI assistant, helpful, knowledgeable, professional, and friendly. "
+            "Use only the provided knowledge to answer questions about Moses's background, skills, projects, and experiences. "
+            "If knowledge is limited, give the most relevant answer possible without making things up. "
+            "Avoid repetitive openings such as 'I'm happy to...' or 'Sure, I'd be glad to...'. "
+            "Begin responses naturally, varying the first sentence. "
+            "Use first person when speaking as Moses. "
+            "Use third person when the question explicitly asks about Moses."
+        )
+
+        self.PROMPT_TEMPLATE = """
+Use the following context to answer the question about Moses clearly and in detail.
+
+Instructions:
+- Avoid starting every response the same way; vary or skip the introduction unless it adds value.
+- Keep answers concise and to the point.
+- Use bullet points for lists.
+- If the question is vague, ask for clarification.
+- If the answer is short but the context allows, expand with relevant details.
+- If unrelated or unanswerable from context, say:
+  "{fallback_response}"
+- Give a short follow-up only when it is truly relevant.
+
+Context:
+{context}
+
+Question:
+{question}
+
+Answer:
+"""
+
+        self.GREETINGS_TRIGGERS = {
+            "hi",
+            "hello",
+            "hey",
+            "greetings",
+            "good morning",
+            "good afternoon",
+            "good evening",
+            "hi?",
+            "hello?",
+            "hey?",
+            "greetings?",
+            "good morning?",
+            "good afternoon?",
+            "good evening?",
+        }
+
+        self.GREETINGS = [
+            "Hi there! I'm Moses's brainy sidekick. Feel free to ask about his work, skills, projects, or even a bit about his personal life!",
+            "Hey! I'm here to help you discover Moses's skills, projects, and professional journey.",
+            "Hello! I can answer questions about Moses's work, experience, and what he's been up to. What would you like to know?",
+            "Hi! 👋 I'm like Siri, but for Moses 😄 Wanna know what he's good at or what he's been working on? Let's chat! 💬🔍",
+            "Greetings, human! 👽 I'm Moses's digital buddy. Ask me anything—skills, projects, secret talents... okay, maybe not too secret 🤫🚀",
+            "Sup! 😎 I'm the all-knowing assistant of Moses. Got questions about his work, skills, projects, or even fun facts about him? Ask about what he does, what he's built, or what makes him awesome.",
+        ]
+
+        self.FALLBACK_RESPONSES = [
+            "Hmm, I don't have enough info to answer that right now. But feel free to ask about Moses's skills, projects, or professional experience!",
+            "That one's a bit outside my data zone! 😅 Try asking about Moses's work, what he's good at, or cool stuff he's built.",
+            "Oops! That question flew over my circuits 🤖💨. But hey, I can tell you all about Moses's projects, skills, or career highlights!",
+            "I couldn't find anything on that—yet! Let's try something else like Moses's background, his latest work, or what he's great at.",
+            "Either I need a software upgrade or that question's too mysterious 😜. Ask me about Moses's projects, skills, or even a fun fact!",
+        ]
+
+        self.BLACKLIST = [
+            # SQL Injection keywords
+            "SELECT",
+            "DROP",
+            "INSERT",
+            "UPDATE",
+            "DELETE",
+            "ALTER",
+            "TRUNCATE",
+            "REPLACE",
+            "EXEC",
+            "EXECUTE",
+            "UNION",
+            "ALL",
+            "CREATE",
+            "GRANT",
+            "REVOKE",
+            "MERGE",
+            "--",
+            ";",
+            "/*",
+            "*/",
+            "@@",
+            "@",
+            "CHAR(",
+            "NCHAR(",
+            "VARCHAR(",
+            "NVARCHAR(",
+            # XSS payload markers
+            "<script>",
+            "</script>",
+            "<img",
+            "onerror=",
+            "onload=",
+            "onclick=",
+            "onmouseover=",
+            "javascript:",
+            "vbscript:",
+            "data:text/html",
+            "<iframe",
+            "</iframe>",
+            "<object",
+            "<embed",
+            # Command injection patterns
+            "|",
+            "&",
+            "&&",
+            "||",
+            "$(",
+            "`",
+            "$(whoami)",
+            "$(ls)",
+            "$(cat",
+            "$(echo",
+            # Path traversal
+            "../",
+            "..\\",
+            "%2e%2e/",
+            "%2e%2e\\",
+            "%2e%2e%2f",
+            "%2e%2e%5c",
+            # Other suspicious patterns
+            "sleep(",
+            "benchmark(",
+            "load_file(",
+            "outfile",
+            "dumpfile",
+        ]
+
+    def load_json_data(self, path):
+        try:
+            with open(path, "r", encoding="utf-8") as f:
+                data = json.load(f)
+
+            documents = []
+
+            if "qa" in data:
+                for item in data["qa"]:
+                    text = f"Q: {item['question']}\nA: {item['answer']}"
+                    documents.append(
+                        Document(
+                            page_content=text,
+                            metadata={
+                                "id": item.get("id", str(uuid4())),
+                                "category": item.get("category", "QA"),
+                            },
+                        )
+                    )
+
+            if "chunks" in data:
+                for item in data["chunks"]:
+                    documents.append(
+                        Document(
+                            page_content=item["chunk"],
+                            metadata={
+                                "id": item.get("id", str(uuid4())),
+                                "category": "Chunk",
+                            },
+                        )
+                    )
+
+            return documents
+
+        except Exception as e:
+            print(f"Error loading JSON data: {e}")
+            return []
+
+    def init_vector_store(self, documents):
+        embeddings_model = HuggingFaceEmbeddings(
+            model_name="sentence-transformers/all-MiniLM-L6-v2"
+        )
+
+        # Clear old data to avoid duplicates
+        if os.path.exists(CHROMA_PATH):
+            shutil.rmtree(CHROMA_PATH)
+
+        uuids = [str(uuid4()) for _ in documents]
+
+        vector_store = Chroma(
+            collection_name="user_data",
+            embedding_function=embeddings_model,
+            persist_directory=CHROMA_PATH,
+        )
+
+        vector_store.add_documents(documents=documents, ids=uuids)
+        return vector_store
+
+    # def sanitize_input(self, user_input):
+    #     cleaned = re.sub(r"[\x00-\x1f\x7f]", "", user_input)
+    #     if len(cleaned) > 200:
+    #         cleaned = cleaned[:200]
+
+    #     for bad in self.BLACKLIST:
+    #         if bad.lower() in cleaned.lower():
+    #             return None
+    #     return cleaned.strip()
+
+    # def correct_spelling(self, text):
+    #     corrected = TextBlob(text).correct()
+    #     return str(corrected)
+
+    def handle_unknown_query(self):
+        return random.choice(self.FALLBACK_RESPONSES)
+
+    def get_next_questions(self):
+        return random.sample(OPTIMIZED_QUESTIONS, 5)
+
+    def get_model(self):
+        return random.choice([model_1, model_2])
+
+    # ---------------MAIN-----------------
+
+    def ask(self, raw_query: str) -> str:
+        # q_corrected = self.correct_spelling(raw_query)
+        # q = self.sanitize_input(q_corrected)
+
+        q = raw_query
+        if q is None or q == "":
+            return random.choice(self.FALLBACK_RESPONSES)
+
+        if q.lower() in self.GREETINGS_TRIGGERS:
+            return random.choice(self.GREETINGS)
+
+        self.conversation_history.append({"role": "user", "content": q})
+
+        if len(self.conversation_history) > MAX_CONVERSATION_HISTORY:
+            self.conversation_history = self.conversation_history[
+                -MAX_CONVERSATION_HISTORY:
+            ]
+
+        docs = self.retriever.invoke(q)
+        # print("Retrieved docs:", docs)
+
+        if not docs:
+            return random.choice(self.FALLBACK_RESPONSES)
+
+        context = "\n".join([d.page_content for d in docs])
+        # print("Context string:\n", context)
+
+        fallback = self.handle_unknown_query()
+        prompt = self.PROMPT_TEMPLATE.format(
+            context=context, question=q, fallback_response=fallback
+        )
+
+        messages = (
+            [
+                {
+                    "role": "system",
+                    "content": self.SYSTEM_MESSSAGE,
+                },
+            ]
+            + self.conversation_history
+            + [
+                {"role": "user", "content": prompt},
+            ]
+        )
+
+        try:
+            completion = self.client.chat.completions.create(
+                model=self.get_model(),
+                messages=messages,
+                temperature=TEMPERATURE,
+                max_completion_tokens=MAX_TOKENS,
+                top_p=TOP_P,
+                stream=False,
+            )
+            response = completion.choices[0].message.content
+            if response and response.strip():
+                return response.strip()
+            else:
+                return "Sorry, I didn't quite get that. Could you please rephrase your question?"
+
+        except Exception as e:
+            return f"Error while calling LLM or retrieving docs: {e}"

data.json

@@ -0,0 +1,691 @@
+{
+  "qa": [
+    {
+      "category": "Education",
+      "question": "What is your Bachelor's degree and academic background?",
+      "answer": "I hold a Bachelor of Science degree in Electrical and Electronics Engineering from Machakos University (2017 - 2023), awarded Second Class Honors (Upper Division). My focus was on electrical systems, complex math and electronic circuit design. I specialized in control systems and embedded programming, and completed projects in IoT applications."
+    },
+    {
+      "category": "Education",
+      "question": "Do you have any technical certifications?",
+      "answer": "Yes, I earned a Certificate in Computer Support and Maintenance from Kisii National Polytechnic (March 2017 - August 2017) with Credit achievement. The training covered hardware troubleshooting and maintenance, network configuration and management, as well as software installation and support."
+    },
+    {
+      "category": "Education",
+      "question": "What secondary education qualifications do you have?",
+      "answer": "I completed my Kenya Certificate of Secondary School Education at Cardinal Otunga High School (2013 - 2017). During this period, I had a strong focus on mathematics and sciences and participated actively in the science club and technology projects. Advanced to the national level in the Engineering Fair under the Department of Energy and Transport with a project focused on automating the detection of overweight vehicles at weighbridges."
+    },
+    {
+      "category": "Education",
+      "question": "What is your primary school education background?",
+      "answer": "I attended Getenga PAG Primary School from 2009 to 2015. Prior to that, I studied at Nyamoronga D.O.K until 2009."
+    },
+
+    {
+      "category": "Continuous Learning",
+      "question": "What topics are you currently learning or interested in?",
+      "answer": "AI & ML: Python, TensorFlow."
+    },
+    {
+      "category": "Continuous Learning",
+      "question": "What topics are you currently learning or interested in?",
+      "answer": "Full-Stack Development: Spring Boot, Angular, .NET."
+    },
+    {
+      "category": "Continuous Learning",
+      "question": "What topics are you currently learning or interested in?",
+      "answer": "Database Management: PostgreSQL, MongoDB optimization."
+    },
+    {
+      "category": "Continuous Learning",
+      "question": "What topics are you currently learning or interested in?",
+      "answer": "DevOps Practices: Docker, CI/CD, Cloud Services."
+    },
+    {
+      "category": "Personal Information",
+      "question": "What is your full name?",
+      "answer": "Moses Mangabo."
+    },
+
+    {
+      "category": "Certification",
+      "question": "What is the Generative AI Professional certification?",
+      "answer": "Generative AI Professional from Oracle University, awarded in August 2025. Proficient in LLMs, OCI Generative AI, RAG, and AI agent deployment. Skills include Large Language Models (LLMs), Prompt Engineering, Model Fine-tuning, LangChain Integration, and more."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Certified AI Foundations certification?",
+      "answer": "Certified AI Foundations from Oracle University, awarded in July 2025. Focused on foundational AI and ML skills with hands-on experience using Oracle Cloud. Skills include AI, ML, Deep Learning, Generative AI, CNNs, RNNs, and LSTMs."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Deep Learning certification?",
+      "answer": "Deep Learning certification from Simplilearn, awarded in June 2025. Covers deep learning fundamentals, CNN, RNN, and deep learning applications. Skills include TensorFlow, Python, and Neural Networks."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the ML and AI certification?",
+      "answer": "ML and AI certification from AWS, awarded in June 2025. Covers fundamentals of Machine Learning and Artificial Intelligence. Skills include AI, ML, Deep Learning, and Generative AI."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Hackathon certification?",
+      "answer": "Hackathon certificate from Equity Bank, awarded in April 2023. Focused on AI-driven solutions for streamlined healthcare operations. Skills include Python, HTML, CSS, JavaScript, Bootstrap, and AI."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Banking and Credit certification?",
+      "answer": "Banking and Credit certification from Moody's, awarded in April 2025. Covers foundations of banking and credit. Skills include Banking Operations and Credit Analysis."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Angular (basic) certification?",
+      "answer": "Angular (basic) certification from HackerRank, awarded in September 2024. Passed the HackerRank skill certification test. Skills include JavaScript and TypeScript."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the SQL Basics certification?",
+      "answer": "SQL Basics certification from HackerRank, awarded in September 2024. Passed the HackerRank skill certification test. Skills include SQL."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the JavaScript certification?",
+      "answer": "JavaScript certification from LinkedIn, awarded in September 2024. Covers from basic syntax to advanced technical concepts. Skills include JavaScript."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Java Algorithms certification?",
+      "answer": "Java Algorithms certification from LinkedIn, awarded in June 2024. Focuses on enhancing Java programming by mastering efficient algorithm design. Skills include Java and Algorithms."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Learning Angular certification?",
+      "answer": "Learning Angular certification from LinkedIn, awarded in June 2024. Comprehensive introduction to Angular covering its key features. Skills include Angular."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Learning TypeScript certification?",
+      "answer": "Learning TypeScript certification from LinkedIn, awarded in June 2024. Covers TypeScript fundamentals for improved JavaScript efficiency and error prevention. Skills include TypeScript."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Memory Management certification?",
+      "answer": "Memory Management certification from LinkedIn, awarded in May 2024. Covers Java memory management including garbage collection, JVM tuning, and spotting memory leaks. Skills include Java and Memory Management."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Spring Boot certification?",
+      "answer": "Spring Boot certification from LinkedIn, awarded in May 2024. Focused on mastering Spring Boot for efficient enterprise Java application development. Skills include Spring Boot and Spring Framework."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Learning JDBC certification?",
+      "answer": "Learning JDBC certification from LinkedIn, awarded in May 2024. Covers Java Database Connectivity (JDBC) for relational database integration. Skills include Java."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Java Collections certification?",
+      "answer": "Java Collections certification from LinkedIn, awarded in May 2024. Focuses on mastering Java Collections framework for efficient data structure management. Skills include Java and Java Frameworks."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Objects and APIs certification?",
+      "answer": "Objects and APIs certification from LinkedIn, awarded in May 2024. Covers Java 17 fundamentals including objects, APIs, inheritance, and error handling. Skills include Java."
+    },
+    {
+      "category": "Certification",
+      "question": "What is the Exception Handling certification?",
+      "answer": "Exception Handling certification from LinkedIn, awarded in May 2024. Focuses on exception handling in Spring Boot applications for robust error management. Skills include Java and Exception Handling."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Generative AI Professional by Oracle University (August 2025). Proficient in LLMs, OCI Generative AI, RAG, and AI agent deployment. Skills include Large Language Models (LLMs), Prompt Engineering, LLM Architectures, Model Fine-tuning, Generative AI, OCI Generative AI Service, OCI AI Clusters, Model Inference, Model Endpoints, AI Security Architecture, LangChain Integration, Oracle Database 23ai, Retrieval-Augmented Generation (RAG), Document Loading and Chunking, Embeddings Creation, Vector Indexing, Similarity Search, RAG Workflow Design, AI Agents Development, Knowledge Base Creation, and Chatbot Deployment."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Certified AI Foundations by Oracle University (July 2025). Foundational AI and ML skills with hands-on experience using Oracle Cloud. Skills include AI, ML, Deep Learning, Generative AI, LLMs, CNNs, RNNs, LSTMs, and Vector Database."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Deep Learning by Simplilearn (June 2025). Covers deep learning fundamentals, CNN, RNN, and Deep Learning applications. Skills include TensorFlow, Python, and Neural Networks."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "ML and AI by AWS (June 2025). Fundamentals of Machine Learning and Artificial Intelligence. Skills include AI, ML, Deep Learning, and Generative AI."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Hackathon by Equity Bank (April 2023). AI-driven solutions for streamlined healthcare operations. Skills include Python, HTML, CSS, JavaScript, Bootstrap, and AI."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Banking and Credit by Moody's (April 2025). Foundations of Banking and Credit. Skills include Banking Operations and Credit Analysis."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Angular (Basic) by Hackerank (September 2024). Passed the Hackerank skill certification test. Skills include JavaScript and TypeScript."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "SQL Basics by Hackerank (September 2024). Passed the Hackerank skill certification test. Skills include SQL."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "JavaScript by LinkedIn (September 2024). Covers basic syntax to advanced technical concepts. Skills include JavaScript."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Java Algorithms by LinkedIn (June 2024). Enhancing Java programming by mastering efficient algorithm design. Skills include Java and Algorithms."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Learning Angular by LinkedIn (June 2024). Comprehensive introduction to Angular, covering its key features. Skills include Angular."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Learning TypeScript by LinkedIn (June 2024). TypeScript fundamentals for improved JavaScript efficiency and error prevention. Skills include TypeScript."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Memory Management by LinkedIn (May 2024). Java Memory Management: Garbage Collection, JVM Tuning, and Spotting Memory Leaks. Skills include Java and Memory Management."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Spring Boot by LinkedIn (May 2024). Master Spring Boot for efficient enterprise Java application development. Skills include Spring Boot and Spring Framework."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Learning JDBC by LinkedIn (May 2024). Master Java Database Connectivity (JDBC) for efficient relational database integration in Java applications. Skills include Java."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Java Collections by LinkedIn (May 2024). Master Java Collections framework for efficient data structure management and operations in Java applications. Skills include Java and Java Frameworks."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Objects and APIs by LinkedIn (May 2024). Master Java 17 fundamentals, including objects, APIs, inheritance, and efficient error handling for modern application development. Skills include Java."
+    },
+    {
+      "category": "Certifications",
+      "question": "What certifications do you hold?",
+      "answer": "Exception Handling by LinkedIn (May 2024). Master exception handling in Spring Boot applications, ensuring robust error management and application stability. Skills include Java and Exception Handling."
+    },
+    {
+      "category": "Experience",
+      "question": "What is your current role and responsibilities at Equity Bank?",
+      "answer": "I work as a Software Developer at Equity Bank (Feb 2025 - Present). I collaborate with developers, designers, QA, DevOps, and product managers to build modern, scalable banking platforms and digital experiences. I focus on improving user experience across six countries, contributing to accessibility, localization, backend API improvements, and support. Continuous learning and teamwork are key aspects of my role."
+    },
+    {
+      "category": "Experience",
+      "question": "What was your role and key projects during your internship at E&M Technology?",
+      "answer": "I was a Software Developer Intern at E&M Technology (Jan 2024 - Feb 2025), working with a diverse team to develop localized solutions for Kenya with potential scalability in Africa. Key projects included an Energy Management System (EMS) for power monitoring and management, an e-bike rental system for Tatu City residents, and a SayonApps initiative for electronics sales. I participated in site visits and client training."
+    },
+    {
+      "category": "Experience",
+      "question": "What experiences did you gain as a Hackathon participant and Digital Banking Trainer at Equity Bank?",
+      "answer": "As a finalist at the Equity Hackathon (Jul 2021 - Oct 2022), I helped design an AI-powered consultation feature to streamline Equity Afya clinic operations. I served as Vice President and President of Machakos ELC, led community initiatives, mentored Wings to Fly scholars, and supported Equity Bank digitization efforts at various branches. I also engaged in environmental activities like tree planting and market clean-ups."
+    },
+    {
+      "category": "Experience",
+      "question": "What were your responsibilities during your Industrial Attachment at Machakos County?",
+      "answer": "During my Industrial Attachment at Machakos County (Jan 2021 - Apr 2021), I designed electronic control systems for solar-powered street lighting and assisted in maintaining network infrastructure. I optimized hardware and software use and supported flood lighting systems by troubleshooting across various locations."
+    },
+    {
+      "category": "Experience",
+      "question": "What is your current role?",
+      "answer": "Software Developer at Equity Bank (Feb 2025 - Present). I work closely with a team of developers, designers, QA, DevOps, and product managers to help build modern and scalable banking platforms and digital experiences. I support efforts to improve user experience, making sure customers across the six countries feel right at home using our system. I contribute to accessibility and localization tasks, improve backend APIs, and offer support to make sure everything runs smoothly. My focus is on continuous learning, teamwork, and building features that truly make banking easier for users. Technologies: Angular, .NET, SCSS, Jest, JavaScript, TypeScript."
+    },
+    {
+      "category": "Experience",
+      "question": "What past roles have you held?",
+      "answer": "Software Developer Intern at E&M Technology (Jan 2024 - Feb 2025). With my background in Engineering, a diverse team and I were assigned to develop localized solutions aimed at making life easier for Kenyans, with the potential to scale across Africa. I worked on an Energy Management System (EMS) that optimized how we monitor and manage power usage. I also contributed to the development of an e-bike rental system designed for residents of Tatu City, and a SayonApps initiative that encouraged customers to purchase electronics and cookers. The EMS was pilot-tested at Ruaraka Apartments to demonstrate proof of concept, while the e-bike system was tested within Tatu City. I actively participated in site visits and client training sessions to support implementation and gather user feedback. Technologies: Spring Boot, Angular, MongoDB, PostgreSQL, DLMS/COSEM, STS Compliance, GPS, JWT, USSD, Daraja API, JUnit, Jasmine, Git."
+    },
+    {
+      "category": "Experience",
+      "question": "What past roles have you held?",
+      "answer": "Hackathon & Digital Banking Trainer at Equity Bank (Jul 2021 - Oct 2022). As a finalist at the Equity Hackathon, I helped design an AI-powered consultation feature that aimed to streamline operations in Equity Afya clinics. This experience deepened my understanding of practical innovation and its real-world impact on healthcare delivery. Beyond the competition, I served as both Vice President and later President of the Machakos ELC, where I helped lead community-focused initiatives. I also participated in mentoring Wings to Fly scholars and supported digitization efforts by Equity Bank at the Voi, Machakos, and Tala branches. Additionally, I took part in environmental activities, including tree planting and market clean-up efforts in Machakos town. Technologies: Leadership, Environmental Stewardship, Python, HTML, CSS, JavaScript, Bootstrap, AI, Microsoft Office Suite."
+    },
+    {
+      "category": "Experience",
+      "question": "What past roles have you held?",
+      "answer": "Industrial Attachment at Machakos County (Jan 2021 - Apr 2021). During my industrial attachment, I designed electronic control systems for solar-powered street lighting and assisted in maintaining network infrastructure. I also helped optimize hardware and software usage, improving overall system efficiency. As part of my role, I visited various locations across Machakos County to troubleshoot and support flood lighting systems. Technologies: AutoCAD, PowerWorld Simulator, MATLAB, Wiring, Circuit Analysis."
+    },
+
+    {
+      "category": "Technical Skills",
+      "question": "What programming languages are you proficient in?",
+      "answer": "Java (Expert), JavaScript (Advanced), TypeScript (Advanced), Micropython (Proficient), Python (Beginner)."
+    },
+    {
+      "category": "Technical Skills",
+      "question": "What frameworks do you use?",
+      "answer": "Spring Boot (Advanced), Angular (Advanced), TensorFlow (Novice)."
+    },
+    {
+      "category": "Technical Skills",
+      "question": "What databases are you familiar with?",
+      "answer": "PostgreSQL (Advanced), MongoDB (Advanced)."
+    },
+    {
+      "category": "Technical Skills",
+      "question": "What DevOps tools do you use?",
+      "answer": "Docker (Above Average)."
+    },
+    {
+      "category": "Technical Skills",
+      "question": "What testing tools do you use?",
+      "answer": "JUnit (Advanced), Jasmine (Proficient), Jest (Intermediate)."
+    },
+    {
+      "category": "Technical Skills",
+      "question": "What operating systems are you comfortable with?",
+      "answer": "Linux (Above Average), Windows (Expert)."
+    },
+    {
+      "category": "Soft Skills",
+      "question": "What soft skills do you possess?",
+      "answer": "Problem Solving (Exceptional), Organizational (Expert), Team Collaboration (Expert), Client Training (Advanced), Technical Documentation (Advanced)."
+    },
+    {
+      "category": "Tech Stack",
+      "question": "What is your frontend tech stack?",
+      "answer": "TypeScript, JavaScript, Angular, HTML/CSS/SCSS."
+    },
+    {
+      "category": "Tech Stack",
+      "question": "What is your backend tech stack?",
+      "answer": "Java, Spring Boot."
+    },
+    {
+      "category": "Tech Stack",
+      "question": "What is your AI/ML tech stack?",
+      "answer": "Python, TensorFlow."
+    },
+    {
+      "category": "Tech Stack",
+      "question": "What databases do you work with?",
+      "answer": "PostgreSQL, MongoDB."
+    },
+    {
+      "category": "Tech Stack",
+      "question": "What DevOps and tools do you use?",
+      "answer": "Docker, Git/GitHub, Linux, Windows, Kicad, Matlab, Tinkercad, MS Office."
+    },
+    {
+      "category": "Technical Skills",
+      "question": "What programming languages are you proficient in and at what level?",
+      "answer": "I am proficient in Java (90%), JavaScript (85%), TypeScript (85%), Micropython (75%), and Python (25%)."
+    },
+    {
+      "category": "Technical Skills",
+      "question": "Which frameworks do you work with and how skilled are you?",
+      "answer": "I work with Spring Boot (85%), Angular (85%), and TensorFlow (10%)."
+    },
+    {
+      "category": "Technical Skills",
+      "question": "What databases do you have experience with?",
+      "answer": "I have experience with PostgreSQL (80%) and MongoDB (80%)."
+    },
+    {
+      "category": "Technical Skills",
+      "question": "Which DevOps tools and operating systems are you familiar with?",
+      "answer": "I am familiar with Docker (60%), Linux (60%), and Windows (90%)."
+    },
+    {
+      "category": "Technical Skills",
+      "question": "What testing tools do you use and how proficient are you?",
+      "answer": "I use JUnit (80%), Jasmine (75%), and Jest (50%)."
+    },
+    {
+      "category": "Soft Skills",
+      "question": "What are your strongest soft skills?",
+      "answer": "My strongest soft skills are Problem Solving (95%), Organizational skills (90%), Team Collaboration (90%), Client Training (85%), and Technical Documentation (85%)."
+    },
+    {
+      "category": "Technical Stack",
+      "question": "What technologies do you use in Frontend development?",
+      "answer": "For Frontend development, I use TypeScript, JavaScript, Angular, and HTML/CSS/SCSS."
+    },
+    {
+      "category": "Technical Stack",
+      "question": "What technologies are in your Backend stack?",
+      "answer": "My Backend stack includes Java and Spring Boot."
+    },
+    {
+      "category": "Technical Stack",
+      "question": "What AI/ML technologies do you work with?",
+      "answer": "I work with Python and TensorFlow for AI/ML projects."
+    },
+    {
+      "category": "Technical Stack",
+      "question": "Which databases do you use in your tech stack?",
+      "answer": "I use PostgreSQL and MongoDB as databases."
+    },
+    {
+      "category": "Technical Stack",
+      "question": "What DevOps tools and general software do you use?",
+      "answer": "I use Docker, Git/GitHub, Linux, Windows, Kicad, Matlab, Tinkercad, and Microsoft Office."
+    },
+
+    {
+      "category": "Projects",
+      "question": "What is the Equity Online project about?",
+      "answer": "Equity Online is a secure, user-friendly, and scalable internet banking platform developed collaboratively at Equity Bank Limited in 2025. It enables individuals and businesses to perform various banking and lifestyle activities conveniently online. The platform was built using JavaScript, TypeScript, Angular, Jest, SCSS, C#, .NET Framework, Azure, Docker, and Kubernetes. Demo: https://equityonline.equitygroupholdings.com/"
+    },
+    {
+      "category": "Projects",
+      "question": "Can you describe the Electricity Metering System you worked on?",
+      "answer": "The Electricity Metering System upgrades how KPLC meters function, allowing remote token recharge, power control, balance checks, and token transfers. It follows DLMS/COSEM standards with role-based access and integrates with major financial services for payments. Built with Spring Boot, Angular, PostgreSQL, MongoDB, USSD, Africa's Talking API, Daraja API, STS, DLMS, and IoT technologies. Demo: https://property.emtechhouse.co.ke:8910/login, Code: https://github.com/Eng-Musa"
+    },
+    {
+      "category": "Projects",
+      "question": "What undergraduate projects did you complete?",
+      "answer": "In my final year at Machakos University, I designed a Social Distance Alert System, Water Level Sensor, and Wireless Switch. These projects were tested in AUTODESK Tinkercad and real-world conditions, focusing on practical, low-cost hardware solutions. Technologies used include Arduino Uno-R3, C++, AUTODESK, TinkerCAD, and IoT. Demo and Code: https://www.tinkercad.com/things/9orIRY1Cqqi-social-distancing-alert-sytem?sharecode=h15kysl84Z508bldvRojDIbx9PHtcSK9zsb7LdxVSew"
+    },
+    {
+      "category": "Projects",
+      "question": "Tell me about the Goldbach Conjecture Verifier project.",
+      "answer": "The Goldbach Conjecture Verifier explores one of the oldest unsolved problems in number theory, originally proposed in 1742. The project was developed personally in 2025 using Java, Spring Boot, Angular, and deployed on Vercel and Render. Demo: https://goldbach-conjecture.vercel.app/, Code: https://github.com/Eng-Musa"
+    },
+    {
+      "category": "Projects",
+      "question": "What are some other notable projects you have worked on recently?",
+      "answer": "I worked on an Employee Onboarding System (2025) built with Angular 20, Sass, TypeScript, and Jest; an Energy Management System (2024) at E&M Technology House using Spring Boot, Angular, MongoDB, and PostgreSQL; M-Swift Website (2024) using Angular, TypeScript, and Firebase; E-Bike Rental System (2024) at E&M Technology House; Sayona pps project (2024); Banking System (2023) developed personally with Java and Postman; and participated in the Equity Hackathon (2023) developing AI-driven healthcare solutions. Most projects have code repositories at https://github.com/Eng-Musa."
+    },
+    {
+      "category": "Projects",
+      "question": "What is Equity Online?",
+      "answer": "Equity Online is a secure, scalable internet banking platform developed at Equity Bank. It enables users to perform banking and lifestyle activities remotely. Built with Angular, .NET Framework, Azure, Docker, and Kubernetes. [Demo](https://equityonline.equitygroupholdings.com/)"
+    },
+    {
+      "category": "Projects",
+      "question": "What is the Electricity Metering System?",
+      "answer": "A smart metering system for KPLC that supports remote token recharge, power control, and peer-to-peer token sharing. Integrated with DLMS/COSEM standards and APIs like Africa's Talking and Daraja. Built with Spring Boot, Angular, PostgreSQL, and MongoDB. [Demo](https://property.emtechhouse.co.ke:8910/login)"
+    },
+    {
+      "category": "Projects",
+      "question": "What is the Goldbach Conjecture Verifier?",
+      "answer": "A personal project exploring the Goldbach Conjecture using a web-based verifier built with Angular and Spring Boot, deployed on Vercel and Render. [Demo](https://goldbach-conjecture.vercel.app/) [Code](https://github.com/Eng-Musa)"
+    },
+    {
+      "category": "Projects",
+      "question": "What is the Employee Onboarding System?",
+      "answer": "A modern onboarding platform with role-based access, built using Angular 20, Sass, TypeScript, and tested with Jest. [Demo](https://employee-management-system-eos.vercel.app/login) [Code](https://github.com/Eng-Musa)"
+    },
+    {
+      "category": "Projects",
+      "question": "What is the M-Swift Website?",
+      "answer": "A responsive landing page for M-Swift Solutions built with Angular, TypeScript, and Firebase. [Demo](https://m-swift-solutions.vercel.app/) [Code](https://github.com/Eng-Musa)"
+    },
+    {
+      "category": "Projects",
+      "question": "What is the E-Bike Rental System?",
+      "answer": "A GPS-enabled bike rental system with payment integration and location-based restrictions for Tatu City. Built with Spring Boot, Angular, PostgreSQL, and GPS API. [Code](https://github.com/Eng-Musa)"
+    },
+    {
+      "category": "Projects",
+      "question": "What is Sayona PPS?",
+      "answer": "A GPS-integrated tracking and reporting system for Sayona, enhancing logistics and asset monitoring. Built with Spring Boot, Angular, PostgreSQL, and GPS API. [Code](https://github.com/Eng-Musa)"
+    },
+    {
+      "category": "Projects",
+      "question": "What is the Banking System project?",
+      "answer": "A basic banking backend system created using Java and Postman for API testing and validation. [Code](https://github.com/Eng-Musa)"
+    },
+    {
+      "category": "Projects",
+      "question": "What was built for the Equity Hackathon?",
+      "answer": "An AI-powered health consultation tool for Equity Afya clinics, offering location-based clinic recommendations. Built with Python, JavaScript, HTML, and CSS. [Demo](https://equity.hackerearth.com/) [Code](https://github.com/Eng-Musa)"
+    },
+    {
+      "category": "Projects",
+      "question": "What are your Undergraduate Projects?",
+      "answer": "Designed hardware solutions including a Social Distance Alert System, Water Level Sensor, and Wireless Switch using Arduino and TinkerCAD. [Demo & Code](https://www.tinkercad.com/things/9orIRY1Cqqi-social-distancing-alert-sytem?sharecode=h15kysl84Z508bldvRojDIbx9PHtcSK9zsb7LdxVSew)"
+    },
+    {
+      "category": "Projects",
+      "question": "What is the summary of all your projects?",
+      "answer": "I have completed 15+ diverse projects ranging from enterprise banking platforms and smart metering systems to AI-powered health tools and IoT-based hardware prototypes. These projects span personal initiatives, hackathon contributions, and professional work at Equity Bank and E&M Technology House."
+    },
+    {
+      "category": "Leadership",
+      "question": "What leadership roles have you held?",
+      "answer": "Team Lead for Energy and Power Squad (Jan 2024 - Feb 2025). Led a cross-functional team focused on developing localized energy solutions, including EMS and e-bike systems. Oversaw technical implementation, site visits, and client engagement."
+    },
+    {
+      "category": "Leadership",
+      "question": "What leadership roles have you held?",
+      "answer": "Vice President, Machakos University Equity Leaders Club Chapter (Feb 2018 - Feb 2019). Collaboratively registered the club and mobilized new members to build a strong foundation for student leadership and community engagement."
+    },
+    {
+      "category": "Leadership",
+      "question": "What leadership roles have you held?",
+      "answer": "President, Machakos University Equity Leaders Club Chapter (Feb 2019 - Dec 2022). Led volunteer mentorship at Kangundo Boys and Machakos Boys, organized Machakos town market clean-up, visited children's homes, and served as a chaperone during Wings to Fly annual congresses."
+    },
+    {
+      "category": "Leadership",
+      "question": "What leadership roles have you held?",
+      "answer": "President, Engineering Club (Dec 2015 - Dec 2016). Spearheaded technical workshops and peer learning initiatives to foster innovation and creative thinking."
+    },
+    {
+      "category": "Leadership",
+      "question": "What leadership roles have you held?",
+      "answer": "Class Representative 4D, Cardinal Otunga Boys (Mar 2013 - Dec 2016). Acted as liaison between students and faculty, advocating for academic and welfare needs while promoting teamwork and discipline."
+    },
+    {
+      "category": "Leadership",
+      "question": "What was your role as Team Lead for the Energy and Power Squad?",
+      "answer": "I served as Team Lead for the Energy and Power Squad from January 2024 to February 2025, overseeing project coordination and leading team efforts in delivering energy-related solutions."
+    },
+    {
+      "category": "Leadership",
+      "question": "What were your responsibilities as Vice President of the Machakos University Equity Leaders Club?",
+      "answer": "As Vice President from February 2018 to February 2019, I collaboratively registered the club and mobilized new members to build a strong leadership community."
+    },
+    {
+      "category": "Leadership",
+      "question": "What did you accomplish as President of the Machakos University Equity Leaders Club?",
+      "answer": "From February 2019 to December 2022, I served as President, leading volunteer mentorship programs at Kangundo Boys and Machakos Boys schools, organizing Machakos town market cleaning, visiting children's homes, and acting as a chaperone for Wings to Fly annual congresses."
+    },
+    {
+      "category": "Leadership",
+      "question": "What was your role in the Engineering Club?",
+      "answer": "I was the Engineering Club President from December 2015 to December 2016, leading club activities and initiatives."
+    },
+    {
+      "category": "Leadership",
+      "question": "Did you hold any representative roles during secondary school?",
+      "answer": "Yes, I was the Class Representative for class 4D at Cardinal Otunga Boys from March 2013 to December 2016."
+    },
+    {
+      "category": "---------------------🛑🛑🛑🛑🛑🛑",
+      "question": "Where are you from?",
+      "answer": "I am from Kenya, in Eastern Africa."
+    },
+    {
+      "category": "Personal",
+      "question": "Where are you from?",
+      "answer": "I am from Nairobi, Kenya."
+    },
+    {
+      "category": "Experience",
+      "question": "How many years of experience do you have in software development?",
+      "answer": "3 years."
+    },
+    {
+      "category": "Languages",
+      "question": "Which languages do you speak?",
+      "answer": "English, Swahili, Ekegusii and some Kamba."
+    },
+    {
+      "category": "Interests",
+      "question": "What outdoor activities do you enjoy?",
+      "answer": "Outside of code, you'll find me out in nature hiking, taking long walks, swimming, running, or biking. Fun fact: My personal best for a 10km run is 39 minutes 😅."
+    },
+    {
+      "category": "Interests",
+      "question": "What kind of content do you enjoy watching?",
+      "answer": "I enjoy watching documentaries,especially those that explore history, science, innovation, and human resilience. They fuel my curiosity and broaden my perspective beyond the tech world. One of my favorite channels is Veritasium"
+    },
+    {
+      "category": "Tools",
+      "question": "What's your preferred development environment?",
+      "answer": "VS Code and IntelliJ IDEA."
+    },
+    {
+      "category": "Contact",
+      "question": "What are your communication channels?",
+      "answer": "+254 727 587 966 | mangabomoses@gmail.com | Tatu City, Kiambu | https://mosesmangabo.vercel.app/ | https://www.linkedin.com/in/moses-mangabo/"
+    },
+    {
+      "category": "Contact",
+      "question": "How can someone reach you or learn more about your work?",
+      "answer": "Phone: +254 727 587 966, Email: mangabomoses@gmail.com, Location: Tatu City, Kiambu, Portfolio: https://mosesmangabo.vercel.app/, LinkedIn: https://www.linkedin.com/in/moses-mangabo/"
+    }
+  ],
+  "chunks": [
+    {
+      "chunk": "Moses Mangabo - full-stack software developer from Nairobi, Kenya. Specializes in Java, Spring Boot, Angular, PostgreSQL, MongoDB and modern frontend tooling."
+    },
+    {
+      "chunk": "Bachelor of Science in Electrical and Electronics Engineering, Machakos University (2017-2023). Graduated Second Class Honors (Upper Division) with emphasis on electrical systems, complex mathematics, electronic circuit design, control systems, and embedded programming."
+    },
+    {
+      "chunk": "Undergraduate IoT projects: Social Distance Alert System, Water Level Sensor and Wireless Switch. Prototyped in AUTODESK Tinkercad and tested in real-world conditions using Arduino Uno-R3 and C++."
+    },
+    {
+      "chunk": "Certificate in Computer Support and Maintenance, Kisii National Polytechnic (Mar-Aug 2017) — practical skills in hardware troubleshooting, network configuration and software installation/support."
+    },
+    {
+      "chunk": "Primary and early education: Attended Nyamoronga D.O.K. until 2009, then Getenga PAG Primary School (2009-2012)."
+    },
+    {
+      "chunk": "Secondary education: Cardinal Otunga High School (2013-2017). Strong focus on mathematics and sciences; advanced to national level in the Engineering Fair with a weighbridge automation project."
+    },
+    {
+      "chunk": "Current role: Software Developer at Equity Bank (Feb 2025 - Present). Builds scalable banking platforms, contributes to accessibility and localization, improves backend APIs and supports cross-functional teams across six countries."
+    },
+    {
+      "chunk": "Previous role: Software Developer Intern at E&M Technology (Jan 2024 - Feb 2025). Worked on Energy Management System (EMS), e-bike rental system, and SayonApps; performed site visits and client trainings during pilot rollouts."
+    },
+    {
+      "chunk": "Energy Management System (EMS): DLMS/COSEM-compliant smart metering solution enabling remote token recharge, power on/off, balance checks and peer-to-peer token transfers. Integrations: USSD, Africa's Talking API, Daraja API, STS compliance, PostgreSQL and MongoDB backends."
+    },
+    {
+      "chunk": "Equity Online project: collaborative internet banking platform (Equity Bank). Tech: Angular, TypeScript, JavaScript, Jest, SCSS, C#, .NET Framework, Azure, Docker, Kubernetes. Demo URL available."
+    },
+    {
+      "chunk": "Goldbach Conjecture Verifier: personal project exploring number theory; built with Java, Spring Boot and Angular and deployed on Vercel/Render as a web-based verifier."
+    },
+    {
+      "chunk": "Tech strengths (concise): Java (expert), JavaScript/TypeScript (advanced), Spring Boot & Angular (advanced), PostgreSQL & MongoDB (advanced), Docker (intermediate)."
+    },
+    {
+      "chunk": "Testing & tooling experience: JUnit (advanced), Jasmine (proficient), Jest (intermediate). Comfortable with Git, CI/CD workflows and VS Code / IntelliJ IDEA development environments."
+    },
+    {
+      "chunk": "AI & certifications summary: Generative AI Professional and Certified AI Foundations (Oracle University, 2025), Deep Learning (Simplilearn), ML & AI (AWS) — hands-on experience with LLM concepts, RAG, embeddings and model inference workflows."
+    },
+    {
+      "chunk": "Hands-on RAG-related skills: document loading and chunking, embeddings creation, vector indexing, similarity search, LangChain integration, and designing RAG retrieval workflows."
+    },
+    {
+      "chunk": "Leadership & volunteering: Team Lead (Energy & Power Squad, Jan 2024-Feb 2025), Vice President (Machakos University Equity Leaders Club, Feb 2018-Feb 2019), President (Feb 2019-Dec 2022). Organized mentorships, community cleanup, and Wings to Fly chaperone duties."
+    },
+    {
+      "chunk": "Early leadership roles: Engineering Club President (Dec 2015-Dec 2016) and Class Representative 4D at Cardinal Otunga Boys (Mar 2013-Dec 2016)."
+    },
+    {
+      "chunk": "Soft skills snapshot: exceptional problem solving, strong organization, team collaboration, client training experience, and technical documentation capabilities."
+    },
+    {
+      "chunk": "Hobbies & fitness: enjoys hiking, long walks, swimming, running and biking. Personal best 10 km run: 39 minutes. Also enjoys watching documentaries (science, history, innovation)."
+    },
+    {
+      "chunk": "Project links and repos: most projects have demos and code hosted (examples: Equity Online demo, EMS demo, Goldbach demo). Primary code repository: https://github.com/Eng-Musa."
+    },
+    {
+      "chunk": "Practical electrical engineering experience: industrial attachment at Machakos County (Jan-Apr 2021) designing solar-powered street lighting control systems and troubleshooting flood lighting and network infrastructure."
+    },
+    {
+      "chunk": "IoT & embedded focus: specialized in embedded programming, control systems, and low-cost hardware prototypes using Arduino and MicroPython where applicable."
+    },
+    {
+      "chunk": "DevOps & environment: experience deploying containerized applications (Docker), working with Azure, and familiar with Kubernetes orchestration for scalable services."
+    },
+    {
+      "chunk": "Moses Mangabo holds a Bachelor of Science in Electrical and Electronics Engineering from Machakos University (2017-2023), graduating with Second Class Honors (Upper Division). His academic focus included electrical systems, complex mathematics, and electronic circuit design. He specialized in control systems and embedded programming, completing IoT-based projects."
+    },
+    {
+      "chunk": "In 2017, Moses earned a Certificate in Computer Support and Maintenance from Kisii National Polytechnic. The program covered hardware troubleshooting, network configuration and management, and software installation and support. He achieved a Credit grade."
+    },
+    {
+      "chunk": "Moses completed his KCSE at Cardinal Otunga High School (2013-2017), excelling in mathematics and sciences. He actively participated in the science club and advanced to the national level in the Engineering Fair with a project on automating overweight vehicle detection at weighbridges."
+    },
+    {
+      "chunk": "Moses attended Getenga PAG Primary School (2009-2012) and previously studied at Nyamoronga D.O.K until 2009. His early education laid the foundation for his technical and analytical skills."
+    },
+    {
+      "chunk": "Moses is currently exploring Artificial Intelligence and Machine Learning, focusing on Python and TensorFlow. His learning includes model training, neural networks, and practical applications of AI in real-world systems."
+    },
+    {
+      "chunk": "Moses is expanding his full-stack development skills with technologies like Spring Boot, Angular, and .NET. He is focused on building scalable, enterprise-grade applications with robust backend and dynamic frontend capabilities."
+    },
+    {
+      "chunk": "Moses is learning PostgreSQL and MongoDB optimization techniques. His focus includes query performance tuning, indexing strategies, and schema design for scalable data systems."
+    },
+    {
+      "chunk": "Moses is gaining hands-on experience in DevOps tools and practices, including Docker, CI/CD pipelines, and cloud services. His goal is to streamline development workflows and improve deployment efficiency."
+    },
+    {
+      "chunk": "Moses earned the Generative AI Professional certification from Oracle University in August 2025. He is proficient in LLMs, OCI Generative AI, RAG, and AI agent deployment. His skills include LangChain integration, model fine-tuning, embeddings creation, vector indexing, similarity search, and chatbot deployment."
+    },
+    {
+      "chunk": "Moses completed the Deep Learning certification from Simplilearn in June 2025. He gained expertise in CNNs, RNNs, and deep learning applications using TensorFlow and Python."
+    },
+    {
+      "chunk": "In June 2025, Moses earned the ML and AI certification from AWS. The course covered core concepts of machine learning, deep learning, and generative AI."
+    },
+    {
+      "chunk": "Moses received a Hackathon certificate from Equity Bank in April 2023 for developing AI-driven healthcare solutions. He utilized Python, HTML, CSS, JavaScript, and Bootstrap to streamline operations."
+    },
+    {
+      "chunk": "In April 2025, Moses earned a Banking and Credit certification from Moody's. He gained foundational knowledge in banking operations and credit analysis."
+    },
+    {
+      "chunk": "Moses holds multiple certifications in Angular and JavaScript, including Angular (basic) from HackerRank and JavaScript from LinkedIn. These validate his proficiency in JavaScript, TypeScript, and Angular development."
+    },
+    {
+      "chunk": "Moses is certified in SQL Basics (HackerRank), Java Algorithms, Java Collections, JDBC, and Java Memory Management (LinkedIn). These credentials highlight his backend development and database integration skills."
+    },
+    {
+      "chunk": "Moses earned certifications in Spring Boot and Exception Handling from LinkedIn in May 2024. He is skilled in building robust enterprise applications and managing errors effectively in Java environments."
+    },
+    {
+      "chunk": "Moses completed certifications in Learning TypeScript and Objects & APIs from LinkedIn. He is proficient in TypeScript fundamentals and Java 17 features including inheritance and error handling."
+    },
+    {
+      "chunk": "Moses is proficient in Retrieval-Augmented Generation (RAG) workflows. His skills include document loading and chunking, embeddings creation, vector indexing, similarity search, LangChain integration, and knowledge base creation. He applies these in chatbot deployment and AI agent development."
+    },
+    {
+      "chunk": "Moses Mangabo's communication channels include: Phone: +254 727 587 966, Email: mangabomoses@gmail.com, Location: Tatu City, Kiambu, Portfolio: https://mosesmangabo.vercel.app/, LinkedIn: https://www.linkedin.com/in/moses-mangabo/"
+    }
+  ]
+}

main.py

@@ -1,7 +1,33 @@
 from fastapi import FastAPI
+from pydantic import BaseModel
+from functools import lru_cache
+from clients.groq_client import GroqClient
 
 app = FastAPI()
 
+class QueryRequest(BaseModel):
+    query: str
+
+# Lazy singleton for GroqClient
+@lru_cache(maxsize=1)
+def get_groq_client():
+    return GroqClient()
+
+@app.post("/chat")
+async def chat_endpoint(request: QueryRequest):
+    try:
+        groq_client = get_groq_client()
+        response = groq_client.ask(request.query)
+        if response.startswith("Error while"):
+            return {"status_code": 500, "response": response, "next_questions": []}
+        return {
+            "status_code": 200,
+            "response": response,
+            "next_questions": groq_client.get_next_questions(),
+        }
+    except Exception as e:
+        return {"status_code": 500, "response": f"Internal error: {e}", "next_questions": []}
+
 @app.get("/")
-def greet_json():
-    return {"Hello": "World!"}
+def healthcheck():
+    return {"status": "ok"}

optimized_quiz.py

@@ -0,0 +1,93 @@
+OPTIMIZED_QUESTIONS = [
+  "What is your Bachelor's degree and academic background?",
+  "Do you have any technical certifications?",
+  "What secondary education qualifications do you have?",
+  "What is your primary school education background?",
+  "What topics are you currently learning or interested in?",
+  "What is your full name?",
+  "What is the Generative AI Professional certification?",
+  "What is the Certified AI Foundations certification?",
+  "What is the Deep Learning certification?",
+  "What is the ML and AI certification?",
+  "What is the Hackathon certification?",
+  "What is the Banking and Credit certification?",
+  "What is the Angular (basic) certification?",
+  "What is the SQL Basics certification?",
+  "What is the JavaScript certification?",
+  "What is the Java Algorithms certification?",
+  "What is the Learning Angular certification?",
+  "What is the Learning TypeScript certification?",
+  "What is the Memory Management certification?",
+  "What is the Spring Boot certification?",
+  "What is the Learning JDBC certification?",
+  "What is the Java Collections certification?",
+  "What is the Objects and APIs certification?",
+  "What is the Exception Handling certification?",
+  "What certifications do you hold?",
+  "What is your current role and responsibilities at Equity Bank?",
+  "What was your role and key projects during your internship at E&M Technology?",
+  "What experiences did you gain as a Hackathon participant and Digital Banking Trainer at Equity Bank?",
+  "What were your responsibilities during your Industrial Attachment at Machakos County?",
+  "What is your current role?",
+  "What past roles have you held?",
+  "What programming languages are you proficient in?",
+  "What frameworks do you use?",
+  "What databases are you familiar with?",
+  "What DevOps tools do you use?",
+  "What testing tools do you use?",
+  "What operating systems are you comfortable with?",
+  "What soft skills do you possess?",
+  "What is your frontend tech stack?",
+  "What is your backend tech stack?",
+  "What is your AI/ML tech stack?",
+  "What databases do you work with?",
+  "What DevOps and tools do you use?",
+  "What programming languages are you proficient in and at what level?",
+  "Which frameworks do you work with and how skilled are you?",
+  "What databases do you have experience with?",
+  "Which DevOps tools and operating systems are you familiar with?",
+  "What testing tools do you use and how proficient are you?",
+  "What are your strongest soft skills?",
+  "What technologies do you use in Frontend development?",
+  "What technologies are in your Backend stack?",
+  "What AI/ML technologies do you work with?",
+  "Which databases do you use in your tech stack?",
+  "What DevOps tools and general software do you use?",
+  "What is the Equity Online project about?",
+  "Can you describe the Electricity Metering System you worked on?",
+  "What undergraduate projects did you complete?",
+  "Tell me about the Goldbach Conjecture Verifier project.",
+  "What are some other notable projects you have worked on recently?",
+  "What is Equity Online?",
+  "What is the Electricity Metering System?",
+  "What is the Goldbach Conjecture Verifier?",
+  "What is the Employee Onboarding System?",
+  "What is the M-Swift Website?",
+  "What is the E-Bike Rental System?",
+  "What is Sayona PPS?",
+  "What is the Banking System project?",
+  "What was built for the Equity Hackathon?",
+  "What are your Undergraduate Projects?",
+  "What is the summary of all your projects?",
+  "What leadership roles have you held?",
+  "What was your role as Team Lead for the Energy and Power Squad?",
+  "What were your responsibilities as Vice President of the Machakos University Equity Leaders Club?",
+  "What did you accomplish as President of the Machakos University Equity Leaders Club?",
+  "What was your role in the Engineering Club?",
+  "Did you hold any representative roles during secondary school?",
+  "Where are you from?",
+  "How many years of experience do you have in software development?",
+  "Which languages do you speak?",
+  "What outdoor activities do you enjoy?",
+  "What kind of content do you enjoy watching?",
+  "What's your preferred development environment?",
+  "What are your communication channels?",
+  "How can someone reach you or learn more about your work?",
+  "What IoT projects did you work on during your undergraduate studies?",
+  "What is your experience with embedded programming and control systems?",
+  "Can you describe your role in developing the Energy Management System at E&M Technology?",
+  "What are your key skills in Retrieval-Augmented Generation (RAG) workflows?",
+  "What volunteer or community engagement activities have you participated in?",
+  "What is your proficiency level in Java, JavaScript, and TypeScript?",
+  "What tools do you use for testing and version control in your development work?"
+]

requirements.txt

@@ -1,2 +1,9 @@
 fastapi
+pydantic
 uvicorn[standard]
+python-dotenv
+groq
+langchain-core
+langchain-huggingface
+langchain-chroma
+sentence-transformers