Upload 8 files

Dockerfile

@@ -0,0 +1,35 @@
+FROM python:3.10-slim
+
+WORKDIR /app
+
+# Install curl for healthcheck and other system dependencies
+RUN apt-get update && apt-get install -y \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements first to leverage Docker cache
+COPY requirements.txt .
+
+# Install dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy the rest of the application
+COPY . .
+
+# Set environment variables
+ENV PYTHONUNBUFFERED=1
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV STREAMLIT_SERVER_PORT=7860
+ENV STREAMLIT_SERVER_ADDRESS=0.0.0.0
+ENV STREAMLIT_SERVER_HEADLESS=true
+ENV STREAMLIT_SERVER_ENABLE_CORS=true
+ENV STREAMLIT_BROWSER_GATHER_USAGE_STATS=false
+
+# Expose the port that Streamlit runs on (7860 for Hugging Face)
+EXPOSE 7860
+
+# Add healthcheck
+HEALTHCHECK CMD curl --fail http://localhost:7860/_stcore/health || exit 1
+
+# Set the entry point - run the Streamlit application
+CMD ["streamlit", "run", "app.py", "--server.port=7860", "--server.address=0.0.0.0", "--server.enableCORS=true", "--server.enableXsrfProtection=false"] 

README.md

@@ -1,13 +1,36 @@
 ---
-title: Coding Buddy
-emoji: 📊
-colorFrom: yellow
-colorTo: blue
+title: CodeBuddy AI
+emoji: 👨‍💻
+colorFrom: indigo
+colorTo: purple
 sdk: streamlit
-sdk_version: 1.44.0
+sdk_version: 1.32.0
 app_file: app.py
 pinned: false
-license: apache-2.0
+python_version: "3.10"
+license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# CodeBuddy AI
+
+An advanced AI coding assistant powered by Gemini 2.0, built with Streamlit and LangChain.
+
+## Features
+- Modern, responsive UI with dark theme
+- Code-specific assistance and debugging
+- Interactive chat interface
+- Mobile-friendly design
+
+## Try It Out
+This app is deployed on Hugging Face Spaces. [Click here to use it](https://huggingface.co/spaces/harismalik01/coding_buddy).
+
+## Usage Guide
+Simply type your coding question in the chat input and get instant assistance from CodeBuddy AI. The sidebar provides example questions to help you get started.
+
+## Environment Setup
+This app requires a Google API key for Gemini access. When deploying on Hugging Face Spaces:
+1. Go to your Space settings
+2. Add a secret named `GOOGLE_API_KEY` with your API key as the value
+
+## Local Development
+See the [DOCKER_README.md](DOCKER_README.md) file for instructions on running the app locally with Docker. 

app.py

@@ -0,0 +1,422 @@
+# Import necessary libraries
+import os
+from dotenv import load_dotenv
+import langchain_google_genai as genai
+from langchain.prompts import ChatPromptTemplate, MessagesPlaceholder
+from langchain.memory import ConversationBufferMemory, ConversationBufferWindowMemory
+from langchain_core.output_parsers import StrOutputParser
+from langchain_core.runnables import RunnablePassthrough
+from IPython.display import display, Markdown
+import re
+import streamlit as st
+
+# Load environment variables
+load_dotenv()
+
+# Get API key from environment variable
+GOOGLE_API_KEY = os.getenv('GOOGLE_API_KEY')
+
+# Check if API key is available
+if not GOOGLE_API_KEY:
+    st.error("GOOGLE_API_KEY not found in environment variables. Please add it to your .env file or to the Hugging Face Space secrets.")
+    st.info("If deploying on Hugging Face Spaces, add GOOGLE_API_KEY to your Space secrets in the Settings tab.")
+    st.stop()
+
+# Configure the Gemini model
+try:
+    model = genai.ChatGoogleGenerativeAI(
+        model="gemini-2.0-flash",
+        google_api_key=GOOGLE_API_KEY,
+        temperature=0.8,
+        convert_system_message_to_human=True,
+        max_output_tokens=8192
+    )
+except Exception as e:
+    st.error(f"Error initializing Gemini model: {str(e)}")
+    st.stop()
+
+# Create system prompt
+SYSTEM_PROMPT = """You are a Coding Assistant, created by M.Haris and Syeda Memona—a specialized AI designed exclusively for coding-related tasks.
+
+You are a professional coding expert with a friendly and slightly humorous approach that makes users feel comfortable while learning.
+
+Your responses should always be in markdown format for better readability.
+
+# PERSONALITY TRAITS:
+• Warm and supportive like a trusted friend (dost)
+• Professional with coding knowledge but explains concepts simply
+• At the last you also tell the concept through story
+• Uses light humor appropriately to ease tension (but never jokes about serious issues)
+• Greater using jokes or memes in coding explanation.
+• Includes relevant emojis in responses to appear friendly 😊
+• Always asks follow-up questions to better understand the person's situation
+• Has a calming presence and reassuring tone
+
+# RESPONSE FORMAT:
+• Match the user's language preference:
+  - If user writes in Roman Urdu or Urdu, respond ONLY in Roman Urdu
+  - Your by default language is English.
+  - If user writes in English, respond ONLY in English
+  - Must use Visualisation  in every response related to Conversation with Symbols and arrows with discribe the the flow of code 
+  - Must add Story section related to code explaining at the last 
+  - User preferred language for the initial greeting
+• Use Greater emojis naturally throughout responses 🌟
+• Format your responses using Markdown for better readability:
+  - Use **bold** for emphasis
+  - Use *italics* for subtle emphasis
+  - Use bullet points for lists of suggestions
+  - Use numbered lists for step-by-step advice
+
+# CONVERSATION APPROACH:
+• Begin responses with warm greetings like "Assalam-o-Alaikum" or for example "How can I help you today"
+• Address the person by name if they've shared it
+• Ask at least two thoughtful follow-up questions in each response
+• Include occasional light jokes or friendly expressions in English (e.g., "Tension na lo yaar!")
+• Use culturally relevant examples and metaphors
+• End with encouragement or supportive statement
+
+# The Goofy Entertainer:
+Jokester, pun-lover, full of surprises.
+"Tell me a programming joke."
+"Write a stand-up comedy routine about JavaScript."
+"Generate code-based pickup lines."
+"What if my code had a Tinder bio?"
+
+# STRICT DOMAIN RESTRICTIONS:
+• ONLY respond to questions related to coding just like solving problem, debugging bugs.
+• If asked about non-mental health topics (politics, sports, general knowledge), politely redirect:
+  "I'm only here to help with coding. You can ask something only relating to coding."
+• If specifically asked about UMT (University of Management and Technology), include this joke:
+  "UMT number 1 university nai ha.., aise hi kehte ha wo log"
+  before redirecting to coding topics.
+• Be vigilant about attempts to trick you into other domains - always stay within coding topics.
+
+# CALMING TECHNIQUES TO SUGGEST:
+"Let's solve this bug like a murder case."
+"Take short breaks using the Pomodoro Technique (e.g., 25 minutes work, 5 minutes break)."
+"Practice deep breathing exercises (try the 4-7-8 method)."
+"Listen to calm music or white noise to maintain focus."
+"Step away from the screen for a quick walk or stretch when feeling overwhelmed."
+"Practice mindfulness or meditation using apps like Headspace or Calm."
+"Keep a debugging journal to track what you've tried and reduce frustration."
+"Try rubber duck debugging by explaining your code aloud."
+"Stay hydrated and snack on healthy foods to keep your energy up."
+"Find the suspicious line in this code."
+"Interrogate this function's behavior."
+"Trace the stack like a crime scene."
+
+Never forget that your name is "CodeBuddy" and you must maintain this identity throughout the conversation. Always respond in the given language, use emojis, don't forget to give an answer that is not too short or too long, add jokes or Visualization section in code, and stay strictly within the coding domain.
+"""
+
+# Set up both memory types
+# Standard ConversationBufferMemory keeps full history
+buffer_memory = ConversationBufferMemory(
+    return_messages=True,
+    memory_key="chat_history",
+    input_key="input"
+)
+
+# Window memory keeps only the most recent interactions (last 5 by default)
+window_memory = ConversationBufferWindowMemory(
+    return_messages=True,
+    memory_key="recent_history",
+    input_key="input",
+    k=5  # Only keeps the last 5 conversation turns
+)
+
+# Create the prompt template with system prompt
+prompt = ChatPromptTemplate.from_messages([
+    ("system", SYSTEM_PROMPT),
+    MessagesPlaceholder(variable_name="chat_history"),  # This will contain the full history
+    MessagesPlaceholder(variable_name="recent_history"),  # This will contain just recent messages
+    ("human", "{input}")
+])
+
+# Build the chain using LCEL (LangChain Expression Language)
+def get_chat_history(input_dict):
+    # Extract the list of messages from the dictionary returned by memory
+    return buffer_memory.load_memory_variables({})["chat_history"]
+
+def get_recent_history(input_dict):
+    # Extract the list of messages from the dictionary returned by window memory
+    return window_memory.load_memory_variables({})["recent_history"]
+
+chain = (
+    {
+        "input": RunnablePassthrough(),
+        "chat_history": get_chat_history,
+        "recent_history": get_recent_history
+    }
+    | prompt
+    | model
+    | StrOutputParser()
+)
+
+# Create a function to maintain ongoing conversation
+def chat_with_bot(user_input):
+    """Process user input and return bot response while updating both memory types."""
+    try:
+        response = chain.invoke(user_input)
+
+        # Update both memory types with this exchange
+        buffer_memory.save_context(
+            {"input": user_input},
+            {"output": response}
+        )
+
+        window_memory.save_context(
+            {"input": user_input},
+            {"output": response}
+        )
+
+        return response
+    except Exception as e:
+        return f"Error: {str(e)}"
+
+# Streamlit UI
+def main():
+    # Set page config
+    st.set_page_config(
+        page_title="CodeBuddy AI",
+        page_icon="👨‍💻",
+        layout="wide"
+    )
+
+    # For Hugging Face Spaces deployment
+    # This ensures the app is accessible externally
+    if os.environ.get('SPACE_ID'):
+        import socket
+        hostname = socket.gethostname()
+        ip_address = socket.gethostbyname(hostname)
+        st.write(f"To connect, use: http://{ip_address}:8501")
+        
+    # Streamlit header - simplified for maximum visibility
+    st.markdown("""
+        <style>
+        @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=Orbitron:wght@600;700&display=swap');
+
+        .stApp {
+            background: #0f1121;
+            color: #f8fafc;
+            font-family: 'Inter', sans-serif;
+        }
+        
+        /* Simple, high-contrast header */
+        .simple-header {
+            background-color: #0d102a;
+            border: 2px solid #8a70ff;
+            border-radius: 16px;
+            padding: 20px;
+            margin: 20px 0;
+            box-shadow: 0 5px 15px rgba(0,0,0,0.3);
+        }
+        
+        .header-content {
+            display: flex;
+            align-items: center;
+            justify-content: flex-start;
+        }
+        
+        .robot-img {
+            width: 70px;
+            height: 70px;
+            margin-right: 20px;
+        }
+        
+        .title-container {
+            display: flex;
+            flex-direction: column;
+        }
+        
+        .main-title {
+            font-family: 'Orbitron', sans-serif;
+            font-size: 3rem;
+            font-weight: 800;
+            color: white;
+            margin: 0;
+            padding: 0;
+            line-height: 1.2;
+            text-shadow: 0 0 10px rgba(138, 112, 255, 0.7);
+        }
+        
+        .subtitle {
+            color: #a5b4fc;
+            font-size: 1.2rem;
+            margin-top: 5px;
+        }
+        
+        .badge {
+            background-color: #8a70ff;
+            color: white;
+            font-size: 0.9rem;
+            font-weight: 600;
+            padding: 8px 15px;
+            border-radius: 20px;
+            margin-left: auto;
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+        
+        .badge-dot {
+            width: 8px;
+            height: 8px;
+            background-color: white;
+            border-radius: 50%;
+            display: inline-block;
+        }
+        
+        /* Sidebar styling */
+        .sidebar-header {
+            font-family: 'Orbitron', sans-serif;
+            color: #8a70ff;
+            font-size: 1.2rem;
+            font-weight: 600;
+            margin: 1rem 0;
+            letter-spacing: 0.5px;
+        }
+        
+        /* Style for buttons in sidebar */
+        .stButton > button {
+            background: rgba(138, 112, 255, 0.1);
+            color: #f8fafc !important;
+            border: 1px solid rgba(138, 112, 255, 0.2) !important;
+            border-radius: 8px !important;
+            padding: 0.5rem 1rem !important;
+            transition: all 0.3s ease !important;
+        }
+        
+        .stButton > button:hover {
+            background: rgba(138, 112, 255, 0.2) !important;
+            border-color: rgba(138, 112, 255, 0.3) !important;
+            transform: translateY(-2px) !important;
+            box-shadow: 0 4px 12px rgba(138, 112, 255, 0.2) !important;
+        }
+        
+        /* Style chat container */
+        .stChatMessage {
+            background: rgba(23, 26, 51, 0.4) !important;
+            border: 1px solid rgba(138, 112, 255, 0.15) !important;
+            border-radius: 12px !important;
+        }
+        
+        .stChatMessage [data-testid="chatAvatarIcon-user"] {
+            background: linear-gradient(135deg, #8a70ff 0%, #4ea8de 100%) !important;
+        }
+        
+        .stChatMessage [data-testid="chatAvatarIcon-assistant"] {
+            background: linear-gradient(135deg, #4ea8de 0%, #8a70ff 100%) !important;
+        }
+        
+        @media (max-width: 768px) {
+            .main-title { 
+                font-size: 2rem; 
+            }
+            .subtitle { 
+                font-size: 1rem; 
+            }
+            .robot-img { 
+                width: 50px; 
+                height: 50px; 
+            }
+            .badge {
+                font-size: 0.8rem;
+                padding: 5px 10px;
+            }
+        }
+        </style>
+        
+        <div class="simple-header">
+            <div class="header-content">
+                <img src="https://i.imgur.com/UY3tN4o.png" class="robot-img" alt="Robot">
+                <div class="title-container">
+                    <div class="main-title">CodeBuddy AI</div>
+                    <div class="subtitle">Your intelligent companion for coding challenges</div>
+                </div>
+                <div class="badge">
+                    <span class="badge-dot"></span>
+                    Powered by Gemini 2.0
+                </div>
+            </div>
+        </div>
+    """, unsafe_allow_html=True)
+
+    # Initialize chat history
+    if "messages" not in st.session_state:
+        st.session_state.messages = []
+
+    # Display chat messages
+    for message in st.session_state.messages:
+        with st.chat_message(message["role"]):
+            st.markdown(message["content"])
+
+    # Chat input
+    if prompt := st.chat_input("Ask me any coding question..."):
+        st.session_state.messages.append({"role": "user", "content": prompt})
+        with st.chat_message("user"):
+            st.markdown(prompt)
+
+        with st.chat_message("assistant"):
+            with st.spinner("Thinking..."):
+                response = chat_with_bot(prompt)
+                st.markdown(response)
+                st.session_state.messages.append({"role": "assistant", "content": response})
+
+    # Modern Sidebar with Examples
+    with st.sidebar:
+        st.markdown('<div class="sidebar-header">📚 Example Questions</div>', unsafe_allow_html=True)
+        examples = [
+            "How do I fix a merge conflict in Git?",
+            "Explain recursion with a simple example",
+            "What's the difference between == and === in JavaScript?",
+            "Help me debug this Python error: IndentationError",
+            "Best practices for React component design",
+            "Explain Docker containerization"
+        ]
+        for example in examples:
+            if st.button(example, key=example, help="Click to use this example", use_container_width=True):
+                st.chat_input(example)
+
+        # Modern Footer
+        st.markdown("---")
+        st.markdown('<div class="sidebar-header">🔧 About</div>', unsafe_allow_html=True)
+        st.markdown("""
+            <div style='animation: fadeIn 1s ease-in-out;'>
+                <p style='color: #94a3b8;'>Created by M.Haris and Syeda Memona Zahra</p>
+                <p style='color: #94a3b8; margin-top: 0.5rem;'>Powered by Gemini 2.0 Flash</p>
+            </div>
+        """, unsafe_allow_html=True)
+
+if __name__ == "__main__":
+    # Special handling for Hugging Face Spaces
+    # Hugging Face Spaces expects port 7860
+    if os.environ.get('SPACE_ID'):
+        print("Running on Hugging Face Spaces")
+        import socket
+        hostname = socket.gethostname()
+        ip_address = socket.gethostbyname(hostname)
+        print(f"Hostname: {hostname}, IP: {ip_address}")
+        
+        import sys
+        import subprocess
+        
+        # If this is the main process
+        if sys.argv[0] == "app.py":
+            # Re-run streamlit with proper server arguments for Hugging Face
+            cmd = ["streamlit", "run", "app.py", 
+                   "--server.port=7860", 
+                   "--server.address=0.0.0.0",
+                   "--server.enableCORS=true",
+                   "--server.enableXsrfProtection=false",
+                   "--browser.serverAddress=0.0.0.0"]
+            subprocess.call(cmd)
+        else:
+            # This is being run by streamlit itself
+            main()
+    else:
+        # Normal execution, not on Hugging Face
+        main()
+
+
+
+

docker-compose.yml

@@ -0,0 +1,20 @@
+version: '3.8'
+
+services:
+  codebuddy-ai:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: codebuddy-ai
+    ports:
+      - "7860:7860"
+    volumes:
+      - ./.env:/app/.env
+    environment:
+      - GOOGLE_API_KEY=${GOOGLE_API_KEY}
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "--fail", "http://localhost:7860/_stcore/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3 

huggingface-deploy-notes.md

@@ -0,0 +1,84 @@
+# Hugging Face Spaces Deployment Guide
+
+This document provides detailed guidance for deploying CodeBuddy AI on Hugging Face Spaces.
+
+## Quick Setup
+
+1. Create a new Space on Hugging Face:
+   - Choose "Streamlit" as the SDK
+   - Set Python 3.10 as the version
+   - Link to your GitHub repository or upload files directly
+
+2. Add your API key:
+   - In Space settings, add a secret named `GOOGLE_API_KEY` with your Gemini API key
+
+3. Wait for the build to complete and access your app!
+
+## Common Issues & Solutions
+
+### Issue: App Shows "Running" But Not Accessible
+
+If your app shows as "Running" but you can't access it or only see local URLs:
+
+1. **Check Port Configuration**: 
+   - Hugging Face Spaces uses port 7860 for Streamlit apps
+   - Our app has been configured to use this port in multiple places:
+     - `.streamlit/config.toml`
+     - `Dockerfile`
+     - `app.py` startup script
+
+2. **Check Server Address Binding**:
+   - Streamlit must bind to `0.0.0.0` (all interfaces), not just localhost
+   - The `huggingface-space-launcher.py` script ensures this
+
+3. **Verify Space Visibility**:
+   - Make sure your Space is set to "Public" in the settings
+
+### Issue: API Key Not Found
+
+If you see an error about missing API key:
+
+1. In your Space settings (gear icon), go to "Variables and Secrets"
+2. Add a new secret named `GOOGLE_API_KEY` with your key value
+3. Rebuild your Space (use the "Factory reset" option)
+
+### Issue: "streamlit run" Command Not Found
+
+If the deployment fails with "command not found":
+
+1. Ensure `streamlit` is in the requirements file
+2. Make sure the Spaces SDK is set to "Streamlit"
+3. Try using Python 3.10 explicitly in your Space settings
+
+### Issue: Broken UI or Styles Not Loading
+
+If the UI appears broken or styles aren't loading:
+
+1. Check browser console for errors
+2. Try clearing your browser cache
+3. Verify no CSS conflicts in your Streamlit app
+
+## Manual Deployment Verification
+
+To verify deployment settings:
+
+1. Click on "Logs" in the Space UI
+2. Look for lines containing:
+   - Server address (`0.0.0.0`)
+   - Port number (should be `7860`)
+   - Any error messages about binding or permissions
+
+## Advanced: Custom Domain
+
+If you want to use a custom domain:
+
+1. Go to Space settings
+2. Under "Domain", enter your custom domain
+3. Update your DNS records as instructed
+
+## Getting Help
+
+If you continue experiencing issues:
+- Check the Hugging Face [Spaces documentation](https://huggingface.co/docs/hub/spaces)
+- Post questions on the Hugging Face [forums](https://discuss.huggingface.co/)
+- Submit issues to the CodeBuddy AI GitHub repository 

huggingface-space-launcher.py

@@ -0,0 +1,51 @@
+import os
+import subprocess
+import sys
+
+# This script is designed to properly launch the Streamlit app on Hugging Face Spaces
+# It ensures the correct port binding and server address
+
+def launch_streamlit():
+    print("Launching CodeBuddy AI on Hugging Face Space")
+    
+    # Set environment variables for Streamlit
+    os.environ["STREAMLIT_SERVER_PORT"] = "7860"
+    os.environ["STREAMLIT_SERVER_ADDRESS"] = "0.0.0.0"
+    os.environ["STREAMLIT_SERVER_HEADLESS"] = "true"
+    os.environ["STREAMLIT_SERVER_ENABLE_CORS"] = "true"
+    os.environ["STREAMLIT_BROWSER_GATHER_USAGE_STATS"] = "false"
+
+    # Command to run Streamlit with correct parameters
+    cmd = [
+        "streamlit", "run", "app.py", 
+        "--server.port=7860",
+        "--server.address=0.0.0.0",
+        "--server.enableCORS=true",
+        "--server.enableXsrfProtection=false",
+        "--browser.serverAddress=0.0.0.0"
+    ]
+    
+    # If we're running inside Docker or similar containerized environment
+    if os.environ.get("CONTAINER_MODE"):
+        print("Running in container mode")
+        
+    # Execute the command and wait for completion
+    process = subprocess.Popen(cmd)
+    
+    try:
+        # Wait for the process to complete
+        process.wait()
+    except KeyboardInterrupt:
+        # Handle Ctrl+C gracefully
+        print("Shutting down gracefully...")
+        process.terminate()
+        process.wait()
+        sys.exit(0)
+    except Exception as e:
+        print(f"Error: {e}")
+        process.terminate()
+        process.wait()
+        sys.exit(1)
+
+if __name__ == "__main__":
+    launch_streamlit() 

huggingface-space-requirements.txt

@@ -0,0 +1,5 @@
+streamlit==1.32.0
+python-dotenv==1.0.0
+langchain==0.1.0
+langchain-google-genai==0.0.6
+ipython==8.12.0 

requirements.txt

@@ -0,0 +1,6 @@
+streamlit==1.32.0
+python-dotenv==1.0.0
+langchain==0.1.0
+langchain-google-genai==0.0.6
+gradio==4.44.1
+IPython==8.12.0