initial

.gitignore

@@ -0,0 +1,40 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+venv/
+env/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/

.huggingface/CODEOWNERS

@@ -0,0 +1 @@
+* @${OWNER}

HUGGINGFACE_DEPLOYMENT.md

@@ -0,0 +1,89 @@
+# Deploying to Hugging Face Spaces
+
+This guide will help you deploy your Gemma-2 Multimodal Chat application to Hugging Face Spaces.
+
+## Prerequisites
+
+1. A [Hugging Face account](https://huggingface.co/join)
+2. A [Hugging Face API token](https://huggingface.co/settings/tokens) with write access
+3. Git installed on your machine
+
+## Deployment Options
+
+You have two options for deploying to Hugging Face Spaces:
+
+### Option 1: Using the Provided Script (Recommended)
+
+We've created a helper script that automates the deployment process:
+
+1. Run the script:
+   ```bash
+   python push_to_huggingface.py
+   ```
+
+2. Follow the prompts to enter your:
+   - Hugging Face username
+   - Space name (or accept the default "gemma-chat")
+   - Hugging Face API token
+   - Email address (for git configuration)
+   - Commit message
+
+3. The script will:
+   - Create a new Space if it doesn't exist
+   - Initialize git if needed
+   - Configure git credentials
+   - Add and commit your files
+   - Push to Hugging Face Spaces
+
+4. Once complete, your application will be available at:
+   `https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME`
+
+### Option 2: Manual Deployment
+
+If you prefer to deploy manually:
+
+1. Create a new Space on [Hugging Face Spaces](https://huggingface.co/spaces)
+   - Choose "Gradio" as the SDK
+   - Set a name for your Space
+
+2. Initialize git in your project directory (if not already done):
+   ```bash
+   git init
+   ```
+
+3. Configure git:
+   ```bash
+   git config --local user.name "YOUR_USERNAME"
+   git config --local user.email "YOUR_EMAIL"
+   ```
+
+4. Add Hugging Face as a remote:
+   ```bash
+   git remote add space https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME
+   ```
+
+5. Add, commit, and push your files:
+   ```bash
+   git add .
+   git commit -m "Initial commit"
+   git push --force space main
+   ```
+
+## Configuration Files
+
+The following files are used for Hugging Face Spaces configuration:
+
+- `README.space.md`: The README displayed on your Space's page
+- `app_config.yaml`: Configuration for your Space (model, hardware, etc.)
+- `.gitignore`: Prevents unnecessary files from being uploaded
+
+## Troubleshooting
+
+- **Authentication Issues**: Make sure your token has write access
+- **Push Errors**: Check if your Space already exists and you have the correct URL
+- **Deployment Failures**: Check the Spaces logs for error messages
+
+## Resources
+
+- [Hugging Face Spaces Documentation](https://huggingface.co/docs/hub/spaces)
+- [Gradio Documentation](https://www.gradio.app/docs/)

README.md

@@ -1,6 +1,6 @@
-# 🚀 Gemma-3 Multimodal Chat Application
+# 🚀 Gemma-2 Multimodal Chat Application
 
-A sophisticated Gradio-based chat application featuring multimodal capabilities with Google's Gemma-3 model (placeholder implementation).
+A sophisticated Gradio-based chat application featuring multimodal capabilities with Google's Gemma-2 model.
 
 ## ✨ Features
 
@@ -14,7 +14,7 @@ A sophisticated Gradio-based chat application featuring multimodal capabilities
 ## 🛠️ Technologies Used
 
 - **Frontend**: Gradio 4.0+
-- **AI Model**: Gemma-3 (placeholder implementation)
+- **AI Model**: Google's Gemma-2-2B-IT
 - **File Processing**: PyPDF2 for PDFs, PIL for images
 - **Backend**: Python with Hugging Face Transformers
 - **Deployment**: Hugging Face Spaces
@@ -73,11 +73,7 @@ A sophisticated Gradio-based chat application featuring multimodal capabilities
 ## 🔧 Configuration
 
 ### Model Configuration
-The application currently uses a placeholder for Gemma-3. To integrate the actual model:
-
-1. Replace the `gemma_3_placeholder_inference` function in `app.py`
-2. Add proper model loading and inference logic
-3. Update dependencies if needed
+The application uses Google's Gemma-2-2B-IT model from Hugging Face. The model is loaded and used for inference in the `gemma_3_inference` function in `app.py`.
 
 ### Customization
 - Modify the UI theme in the `gr.Blocks` configuration
@@ -97,7 +93,7 @@ gemma/
 
 ## 🔮 Future Enhancements
 
-- [ ] Integration with actual Gemma-3 model
+- [ ] Upgrade to Gemma-3 model when available
 - [ ] Support for additional file formats (DOCX, XLSX)
 - [ ] Advanced image processing capabilities
 - [ ] User authentication and personalized chat history
@@ -129,4 +125,4 @@ If you encounter any issues or have questions, please open an issue on the repos
 
 ---
 
-**Note**: This application currently uses a placeholder implementation for Gemma-3. Replace the placeholder functions with actual model integration when the model becomes available.
+**Note**: This application uses Google's Gemma-2-2B-IT model. The model doesn't have native vision capabilities, but the application is designed to handle image uploads with appropriate messaging.

README.space.md

@@ -0,0 +1,57 @@
+---
+title: Gemma-2 Multimodal Chat
+description: A sophisticated Gradio-based chat application featuring multimodal capabilities with Google's Gemma-2 model.
+emoji: 🚀
+colorFrom: blue
+colorTo: purple
+sdk: gradio
+sdk_version: 4.0.0
+python_version: 3.9
+pinned: false
+license: mit
+---
+
+# 🚀 Gemma-2 Multimodal Chat Application
+
+A sophisticated Gradio-based chat application featuring multimodal capabilities with Google's Gemma-2 model.
+
+## ✨ Features
+
+- 💬 **Interactive Chat Interface**: Persistent conversation history with context awareness
+- 🖼️ **Vision Capabilities**: Upload and analyze images (note: Gemma-2 doesn't have native vision capabilities)
+- 📄 **File Processing**: Support for PDF and TXT file uploads with text extraction
+- 🧠 **Contextual Responses**: Maintains conversation context for follow-up questions
+- 🎨 **Modern UI**: Clean, responsive interface built with Gradio
+
+## 📖 How to Use
+
+### Basic Chat
+1. Type your message in the text input box
+2. Click "Submit" or press Enter
+3. View the AI response in the chat history
+
+### Image Analysis
+1. Upload an image using the image upload component
+2. Type a question about the image
+3. Submit to get AI-powered image analysis (note: Gemma-2 doesn't have native vision capabilities)
+
+### File Processing
+1. Upload a PDF or TXT file using the file upload component
+2. Ask questions about the file content
+3. The extracted text will be used as context for responses
+
+### Advanced Features
+- **Persistent Context**: Previous conversations are remembered
+- **File Context**: Uploaded file content persists for follow-up questions
+- **Clear Chat**: Reset conversation history and uploaded files
+
+## 🛠️ Technologies Used
+
+- **Frontend**: Gradio 4.0+
+- **AI Model**: Google's Gemma-2-2B-IT
+- **File Processing**: PyPDF2 for PDFs, PIL for images
+- **Backend**: Python with Hugging Face Transformers
+
+## 📄 License
+
+This project is licensed under the MIT License.

app.py

@@ -40,7 +40,7 @@ def load_gemma_model():
 
 def gemma_3_inference(prompt_text: str, pil_image: Optional[Image.Image] = None, chat_history: Optional[List[Tuple[str, str]]] = None) -> str:
     """
-    Real Gemma model inference function.
+    Gemma-2 model inference function.
     """
     global model, tokenizer
     
@@ -205,7 +205,7 @@ def clear_chat(chat_history: List[Tuple[str, str]], file_context: str) -> Tuple[
     return [], "", None, None, ""
 
 # Create Gradio interface
-with gr.Blocks(title="Gemma-3 Multimodal Chat", theme=gr.themes.Soft()) as demo:
+with gr.Blocks(title="Gemma-2 Multimodal Chat", theme=gr.themes.Soft()) as demo:
     gr.Markdown(
         """
         # 🚀 Gemma-2 Multimodal Chat Application
@@ -276,7 +276,7 @@ with gr.Blocks(title="Gemma-3 Multimodal Chat", theme=gr.themes.Soft()) as demo:
                 - Upload either an image OR a file per message
                 - PDF files will have their text extracted
                 - File content persists as context for follow-up questions
-                - Images are processed with vision capabilities
+                - Note: Gemma-2 doesn't have native vision capabilities, but you can still upload images and ask text-based questions about them
                 """
             )
     

app_config.yaml

@@ -1,4 +1,4 @@
-title: Gemma-3 Multimodal Chat
+title: Gemma-2 Multimodal Chat
 emoji: 🚀
 colorFrom: blue
 colorTo: purple
@@ -17,6 +17,6 @@ tags:
   - gradio
 python_version: 3.9
 models:
-  - google/gemma-2b-it
+  - google/gemma-2-2b-it
 hardware: cpu-basic
 suggested_storage: small

push_to_huggingface.bat

@@ -0,0 +1,28 @@
+@echo off
+echo.
+echo 🚀 Pushing Gemma-2 Multimodal Chat to Hugging Face Spaces
+echo.
+
+REM Check if Python is installed
+python --version >nul 2>&1
+if %ERRORLEVEL% NEQ 0 (
+    echo ❌ Python is not installed or not in PATH. Please install Python and try again.
+    exit /b 1
+)
+
+REM Run the Python script
+python push_to_huggingface.py
+
+if %ERRORLEVEL% EQU 0 (
+    echo.
+    echo ✅ Deployment script completed successfully!
+    echo.
+    echo Press any key to exit...
+    pause >nul
+) else (
+    echo.
+    echo ❌ Deployment script encountered an error.
+    echo.
+    echo Press any key to exit...
+    pause >nul
+)

push_to_huggingface.py

@@ -0,0 +1,112 @@
+import os
+import subprocess
+import sys
+
+def push_to_huggingface():
+    """
+    Script to help push the Gemma-2 Multimodal Chat application to Hugging Face Spaces.
+    """
+    print("\n🚀 Pushing Gemma-2 Multimodal Chat to Hugging Face Spaces\n")
+    
+    # Check if git is installed
+    try:
+        subprocess.run(["git", "--version"], check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+    except (subprocess.SubprocessError, FileNotFoundError):
+        print("❌ Git is not installed or not in PATH. Please install Git and try again.")
+        return False
+    
+    # Check if huggingface_hub is installed
+    try:
+        import huggingface_hub
+    except ImportError:
+        print("📦 Installing huggingface_hub...")
+        subprocess.run([sys.executable, "-m", "pip", "install", "huggingface_hub"], check=True)
+        import huggingface_hub
+    
+    # Get Hugging Face username and space name
+    username = input("Enter your Hugging Face username: ").strip()
+    space_name = input("Enter a name for your Hugging Face Space (default: gemma-chat): ").strip() or "gemma-chat"
+    
+    # Full space name
+    full_space_name = f"{username}/{space_name}"
+    print(f"\n🔍 Space will be created at: https://huggingface.co/spaces/{full_space_name}")
+    
+    # Get Hugging Face token
+    token = input("Enter your Hugging Face token (create one at https://huggingface.co/settings/tokens): ").strip()
+    if not token:
+        print("❌ Token is required to push to Hugging Face Spaces.")
+        return False
+    
+    # Create or check if space exists
+    try:
+        from huggingface_hub import HfApi, create_repo
+        
+        api = HfApi(token=token)
+        
+        # Check if space already exists
+        try:
+            api.repo_info(repo_id=full_space_name, repo_type="space")
+            print(f"ℹ️ Space {full_space_name} already exists. Will push to existing space.")
+        except Exception:
+            # Create new space
+            print(f"🆕 Creating new Hugging Face Space: {full_space_name}")
+            create_repo(
+                repo_id=space_name,
+                token=token,
+                repo_type="space",
+                space_sdk="gradio",
+                private=False
+            )
+    except Exception as e:
+        print(f"❌ Error creating/checking space: {str(e)}")
+        return False
+    
+    # Initialize git if not already initialized
+    if not os.path.exists(".git"):
+        print("🔄 Initializing git repository...")
+        subprocess.run(["git", "init"], check=True)
+    
+    # Configure git
+    print("🔄 Configuring git...")
+    subprocess.run(["git", "config", "--local", "user.name", username], check=True)
+    email = input("Enter your email for git configuration: ").strip()
+    if email:
+        subprocess.run(["git", "config", "--local", "user.email", email], check=True)
+    
+    # Add Hugging Face as remote
+    print("🔄 Adding Hugging Face as remote...")
+    try:
+        subprocess.run(["git", "remote", "remove", "space"], check=False, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+    except subprocess.SubprocessError:
+        pass  # Ignore if remote doesn't exist
+    
+    subprocess.run(["git", "remote", "add", "space", f"https://huggingface.co/spaces/{full_space_name}"], check=True)
+    
+    # Add files to git
+    print("🔄 Adding files to git...")
+    subprocess.run(["git", "add", "."], check=True)
+    
+    # Commit changes
+    print("🔄 Committing changes...")
+    commit_message = input("Enter a commit message (default: Initial commit): ").strip() or "Initial commit"
+    subprocess.run(["git", "commit", "-m", commit_message], check=True)
+    
+    # Configure git credentials
+    print("🔄 Configuring git credentials...")
+    credential_helper = f"!f() {{ echo username={username}; echo password={token}; }}; f"
+    subprocess.run(["git", "config", "--local", "credential.helper", credential_helper], check=True)
+    
+    # Push to Hugging Face
+    print("\n🚀 Pushing to Hugging Face Spaces...")
+    try:
+        subprocess.run(["git", "push", "--force", "space", "main"], check=True)
+        print("\n✅ Successfully pushed to Hugging Face Spaces!")
+        print(f"🌐 Your application is now available at: https://huggingface.co/spaces/{full_space_name}")
+        return True
+    except subprocess.SubprocessError as e:
+        print(f"\n❌ Error pushing to Hugging Face Spaces: {str(e)}")
+        print("Please check your token and try again.")
+        return False
+
+if __name__ == "__main__":
+    push_to_huggingface()