Community Contribution for #Week 1: add Alter-Ego chatbot using AzurwOpenAI and Gradio

1_foundations/community_contributions/alter-ego-gradio-chatbot-usingAzureOpenai/.env.example

@@ -0,0 +1,8 @@
+# Azure OpenAI Configuration
+AZURE_OPENAI_API_KEY=your_azure_openai_api_key_here
+AZURE_OPENAI_ENDPOINT=https://your-resource-name.openai.azure.com/
+AZURE_OPENAI_DEPLOYMENT=gpt-4o-mini
+
+# Pushover Notifications (for visitor engagement alerts)
+PUSHOVER_USER=your_pushover_user_key
+PUSHOVER_TOKEN=your_pushover_app_token

1_foundations/community_contributions/alter-ego-gradio-chatbot-usingAzureOpenai/.gitignore

@@ -0,0 +1,33 @@
+# Environment variables (contains API keys)
+.env
+.env.local
+.env.production
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+
+# Virtual environments
+venv/
+.venv/
+env/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+uv.lock

1_foundations/community_contributions/alter-ego-gradio-chatbot-usingAzureOpenai/README.md

@@ -0,0 +1,68 @@
+# Alter-Ego Chatbot
+
+A professional chatbot that represents you on your website. It answers questions about your background, experience, and skills using Azure OpenAI and Gradio.
+
+## What It Does
+
+- Loads your professional info from a PDF resume/LinkedIn profile and text summary
+- Responds to visitor questions about you using Azure OpenAI's GPT-4o-mini
+- Captures interested visitor emails and logs unanswered questions
+- Sends notifications via Pushover when users engage
+
+## Quick Start
+
+### Requirements
+- Python 3.12+
+- Azure OpenAI API key and deployment name
+- Pushover API credentials (for notifications)
+
+### Setup
+
+1. **Clone and install dependencies:**
+```bash
+pip install -e .
+```
+
+2. **Create a `.env` file with:**
+```bash
+cp .env.example .env
+```
+Then edit `.env` with your actual values:
+```
+AZURE_OPENAI_API_KEY=your_key
+AZURE_OPENAI_ENDPOINT=your_endpoint
+AZURE_OPENAI_DEPLOYMENT=gpt-4o-mini
+PUSHOVER_USER=your_pushover_user
+PUSHOVER_TOKEN=your_pushover_token
+```
+
+3. **Add your data:**
+   - Place your resume/LinkedIn PDF as `static/profile.pdf`
+   - Create `static/summary.txt` with a brief professional summary
+
+### Run It
+
+```bash
+python main.py
+```
+
+Opens a chat interface at `http://localhost:7860`
+
+## How It Works
+
+- **agent.py**: Main chat loop using Azure OpenAI
+- **prompt.py**: Loads your profile data and builds the system prompt
+- **tools.py**: Handles user email capture and logging unknown questions
+- **main.py**: Launches the Gradio interface
+
+## Customization
+
+Edit `main.py` to change:
+- Your name in `ConversationAgent(name="Your Name")`
+- Chat title and description
+- Example questions
+
+## Notes
+
+- Make sure `static/profile.pdf` and `static/summary.txt` exist or the agent will use placeholder text
+- The chatbot stays in character as you and prioritizes answering from your provided context

1_foundations/community_contributions/alter-ego-gradio-chatbot-usingAzureOpenai/agent.py

@@ -0,0 +1,46 @@
+from openai import AzureOpenAI
+from dotenv import load_dotenv
+import os
+from tools import handle_tool_calls, TOOLS
+from prompt import build_system_prompt
+
+load_dotenv()
+
+
+class ConversationAgent:
+    def __init__(self, name="Harsh Patel"):
+        """Initialize the agent with Azure OpenAI client and system prompt."""
+        self.client = AzureOpenAI(
+            azure_deployment=os.getenv("AZURE_OPENAI_DEPLOYMENT")
+        )
+        self.name = name
+        self.system_prompt = build_system_prompt(name)
+
+    def chat(self, message, history):
+        messages = (
+            [{"role": "system", "content": self.system_prompt}]
+            + history
+            + [{"role": "user", "content": message}]
+        )
+
+        done = False
+        while not done:
+            response = self.client.chat.completions.create(
+                model="gpt-4o-mini",
+                messages=messages,
+                tools=TOOLS
+            )
+
+            finish_reason = response.choices[0].finish_reason
+
+            if finish_reason == "tool_calls":
+                message_with_tool_calls = response.choices[0].message
+                tool_calls = message_with_tool_calls.tool_calls
+                tool_results = handle_tool_calls(tool_calls)
+
+                messages.append(message_with_tool_calls)
+                messages.extend(tool_results)
+            else:
+                done = True
+
+        return response.choices[0].message.content

1_foundations/community_contributions/alter-ego-gradio-chatbot-usingAzureOpenai/main.py

@@ -0,0 +1,24 @@
+from agent import ConversationAgent
+
+
+def main():
+    """Initialize and launch the chat interface."""
+    from gradio.chat_interface import ChatInterface
+
+    # TODO: Change this to your actual name
+    agent = ConversationAgent(name="Harsh Patel")
+
+    ChatInterface(
+        fn=agent.chat,
+        title=f"Chat with {agent.name}",
+        description="Ask me anything about my professional background, experience, and skills.",
+        examples=[
+            "What's your background?",
+            "Tell me about your technical skills",
+            "What kind of projects have you worked on?",
+        ],
+    ).launch()
+
+
+if __name__ == "__main__":
+    main()

1_foundations/community_contributions/alter-ego-gradio-chatbot-usingAzureOpenai/prompt.py

@@ -0,0 +1,86 @@
+from pypdf import PdfReader
+import os
+
+
+def load_linkedin_profile(pdf_path="static/profile.pdf"):
+    """Load and extract text from LinkedIn profile PDF."""
+    if os.path.exists(pdf_path):
+        reader = PdfReader(pdf_path)
+        content = ""
+        for page in reader.pages:
+            text = page.extract_text()
+            if text:
+                content += text
+        return content
+    return "Profile PDF not found."
+
+
+def load_summary(summary_path="static/summary.txt"):
+    """Load the professional summary from text file."""
+    if os.path.exists(summary_path):
+        with open(summary_path, "r", encoding="utf-8") as f:
+            return f.read()
+    return "Summary text not found."
+
+
+def build_system_prompt(name="Harsh Patel"):
+    summary = load_summary()
+    linkedin_profile = load_linkedin_profile()
+
+    prompt = f"""You are {name}'s AI representative on their professional website.
+
+    ## Your Role and Responsibilities:
+
+    You represent {name} for all interactions on this website. Your primary goals are:
+
+    1. **Information Provider**: Answer questions about {name}'s:
+    - Professional background and experience
+    - Technical skills and expertise
+    - Education and achievements
+    - Career trajectory and current focus
+    - Notable projects and accomplishments
+
+    2. **Engagement Facilitator**: 
+    - Maintain a professional yet personable tone
+    - Engage visitors as potential clients, collaborators, or employers
+    - Show genuine interest in the visitor's needs and questions
+    - Keep conversations focused and productive
+
+    3. **Lead Capture**: 
+    - When appropriate, guide interested visitors toward direct contact
+    - Politely request contact information (especially email addresses)
+    - Use the record_user_details tool to capture visitor information
+    - Record context about why they're interested for follow-up
+
+    4. **Continuous Improvement**:
+    - Use record_unknown_question tool for ANY question you cannot confidently answer
+    - This includes questions about personal details, preferences, or anything not in your knowledge base
+    - Even trivial questions should be logged to improve future responses
+
+    ## Communication Guidelines:
+
+    - Be conversational but professional
+    - Provide specific, relevant details from the available information
+    - If uncertain, acknowledge it gracefully and log the question
+    - Proactively suggest next steps (e.g., "Would you like to connect via email?")
+    - Avoid being overly salesy; focus on authentic value and connection
+
+    ## Available Context:
+
+    ### Professional Summary:
+    {summary}
+
+    ### LinkedIn Profile:
+    {linkedin_profile}
+
+    ## Important Notes:
+
+    - Always stay in character as {name}
+    - Use the provided context to give accurate, detailed responses
+    - When you don't know something, always log it with record_unknown_question
+    - Prioritize building genuine connections with visitors
+    - Your responses should reflect {name}'s professional voice and expertise
+
+    Now, engage with the visitor and represent {name} to the best of your ability."""
+
+    return prompt

1_foundations/community_contributions/alter-ego-gradio-chatbot-usingAzureOpenai/pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "alter-ego-gradio-chatbot-usingazureopenai"
+version = "0.1.0"
+description = "A professional chatbot that represents you on your website. It answers questions about your background, experience, and skills using Azure OpenAI and Gradio."
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "gradio>=6.3.0",
+    "openai>=2.15.0",
+    "pypdf>=6.6.0",
+    "python-dotenv>=1.2.1",
+    "requests>=2.32.5",
+]

1_foundations/community_contributions/alter-ego-gradio-chatbot-usingAzureOpenai/static/summary.txt.example

@@ -0,0 +1,22 @@
+# Example summary.txt
+
+Replace this file with your own professional summary. This should be a comprehensive overview of:
+
+- Your professional background and experience
+- Technical skills and expertise areas  
+- Notable projects and achievements
+- Education and certifications
+- Personal interests and values
+- Career objectives and what you're looking for
+
+Keep it conversational but professional - this forms the foundation of how your AI chatbot will represent you.
+
+Example structure:
+- Start with a brief intro (role, location, years of experience)
+- Highlight key technical skills and tools
+- Mention domain expertise and notable projects
+- Include education/background
+- Add personal touches (hobbies, interests, values)
+- End with professional philosophy or what you're seeking
+
+See the current summary.txt for a complete example.