Upload folder using huggingface_hub

.gitignore

@@ -0,0 +1,126 @@
+# Environment variables
+.env
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# pdm
+.pdm.toml
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cedric Laridon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,12 +1,111 @@
 ---
-title: Cedric Agent
-emoji: 💻
-colorFrom: indigo
-colorTo: yellow
+title: cedric-agent
+app_file: app.py
 sdk: gradio
 sdk_version: 5.39.0
-app_file: app.py
-pinned: false
 ---
+# Cedric Agent - Personal AI Chatbot
+
+A personal AI chatbot that represents Cedric Laridon on his website, answering questions about his career, background, skills, and experience.
+
+## Features
+
+- **Personal AI Assistant**: Acts as Cedric Laridon, answering questions about his professional background
+- **LinkedIn Integration**: Uses Cedric's LinkedIn profile data to provide accurate responses
+- **Contact Recording**: Captures visitor contact information and unknown questions via Pushover notifications
+- **Web Interface**: Clean Gradio interface for easy interaction
+- **Professional Engagement**: Designed to engage potential clients and employers
+
+## Setup
+
+### Prerequisites
+
+- Python 3.12 or higher
+- [uv](https://docs.astral.sh/uv/) (recommended) or pip
+- OpenAI API key
+- Pushover account (optional, for notifications)
+
+### Installation
+
+1. Clone the repository:
+```bash
+git clone https://github.com/cedriclaridon/cedric-agent.git
+cd cedric-agent
+```
+
+2. Install dependencies using uv (recommended):
+```bash
+uv sync
+```
+
+   Or using pip:
+```bash
+pip install -r requirements.txt
+```
+
+3. Create a `.env` file in the root directory with your API keys:
+```env
+OPENAI_API_KEY=your_openai_api_key_here
+PUSHOVER_TOKEN=your_pushover_token_here
+PUSHOVER_USER=your_pushover_user_key_here
+```
+
+### Running the Application
+
+Using uv (recommended):
+```bash
+uv run python app.py
+```
+
+Or using python directly:
+```bash
+python app.py
+```
+
+The application will launch a Gradio interface, typically accessible at `http://localhost:7860`.
+
+## Configuration
+
+### Environment Variables
+
+- `OPENAI_API_KEY`: Required. Your OpenAI API key for GPT-4o-mini
+- `PUSHOVER_TOKEN`: Optional. Pushover application token for notifications
+- `PUSHOVER_USER`: Optional. Pushover user key for notifications
+
+### Personal Data
+
+The chatbot uses two main sources of personal information:
+
+1. **`me/summary.txt`**: A brief personal summary
+2. **`me/cedric-linkedin.pdf`**: LinkedIn profile export in PDF format
+
+Update these files with your own information to customize the chatbot for your use.
+
+## How It Works
+
+1. **System Prompt**: The chatbot is given a comprehensive system prompt that includes personal summary and LinkedIn data
+2. **Function Calling**: Uses OpenAI's function calling to record user details and unknown questions
+3. **Notifications**: Sends real-time notifications via Pushover when users provide contact info or ask unknown questions
+4. **Conversation Flow**: Designed to engage users and encourage them to provide contact information
+
+## Customization
+
+To adapt this chatbot for your own use:
+
+1. Replace `me/summary.txt` with your personal summary
+2. Replace `me/cedric-linkedin.pdf` with your LinkedIn profile PDF
+3. Update the name in `app.py` (line 80: `self.name = "Your Name"`)
+4. Modify the system prompt in the `system_prompt()` method if needed
+5. Update the contact information in this README
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+This is a personal project, but feel free to fork it and adapt it for your own use. If you have suggestions for improvements, please open an issue.
+
+## Contact
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+For questions about this project, please contact Cedric Laridon through the chatbot interface or via the contact methods provided on his website.

app.py

@@ -0,0 +1,134 @@
+from dotenv import load_dotenv
+from openai import OpenAI
+import json
+import os
+import requests
+from pypdf import PdfReader
+import gradio as gr
+
+
+load_dotenv(override=True)
+
+def push(text):
+    requests.post(
+        "https://api.pushover.net/1/messages.json",
+        data={
+            "token": os.getenv("PUSHOVER_TOKEN"),
+            "user": os.getenv("PUSHOVER_USER"),
+            "message": text,
+        }
+    )
+
+
+def record_user_details(email, name="Name not provided", notes="not provided"):
+    push(f"Recording {name} with email {email} and notes {notes}")
+    return {"recorded": "ok"}
+
+def record_unknown_question(question):
+    push(f"Recording {question}")
+    return {"recorded": "ok"}
+
+record_user_details_json = {
+    "name": "record_user_details",
+    "description": "Use this tool to record that a user is interested in being in touch and provided an email address",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "email": {
+                "type": "string",
+                "description": "The email address of this user"
+            },
+            "name": {
+                "type": "string",
+                "description": "The user's name, if they provided it"
+            }
+            ,
+            "notes": {
+                "type": "string",
+                "description": "Any additional information about the conversation that's worth recording to give context"
+            }
+        },
+        "required": ["email"],
+        "additionalProperties": False
+    }
+}
+
+record_unknown_question_json = {
+    "name": "record_unknown_question",
+    "description": "Always use this tool to record any question that couldn't be answered as you didn't know the answer",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "question": {
+                "type": "string",
+                "description": "The question that couldn't be answered"
+            },
+        },
+        "required": ["question"],
+        "additionalProperties": False
+    }
+}
+
+tools = [{"type": "function", "function": record_user_details_json},
+        {"type": "function", "function": record_unknown_question_json}]
+
+
+class Me:
+
+    def __init__(self):
+        self.openai = OpenAI()
+        self.name = "Cedric Laridon"
+        reader = PdfReader("me/cedric-linkedin.pdf")
+        self.linkedin = ""
+        for page in reader.pages:
+            text = page.extract_text()
+            if text:
+                self.linkedin += text
+        with open("me/summary.txt", "r", encoding="utf-8") as f:
+            self.summary = f.read()
+
+
+    def handle_tool_call(self, tool_calls):
+        results = []
+        for tool_call in tool_calls:
+            tool_name = tool_call.function.name
+            arguments = json.loads(tool_call.function.arguments)
+            print(f"Tool called: {tool_name}", flush=True)
+            tool = globals().get(tool_name)
+            result = tool(**arguments) if tool else {}
+            results.append({"role": "tool","content": json.dumps(result),"tool_call_id": tool_call.id})
+        return results
+    
+    def system_prompt(self):
+        system_prompt = f"You are acting as {self.name}. You are answering questions on {self.name}'s website, \
+particularly questions related to {self.name}'s career, background, skills and experience. \
+Your responsibility is to represent {self.name} for interactions on the website as faithfully as possible. \
+You are given a summary of {self.name}'s background and LinkedIn profile which you can use to answer questions. \
+Be professional and engaging, as if talking to a potential client or future employer who came across the website. \
+If you don't know the answer to any question, use your record_unknown_question tool to record the question that you couldn't answer, even if it's about something trivial or unrelated to career. \
+If the user is engaging in discussion, try to steer them towards getting in touch via email; ask for their email and record it using your record_user_details tool. "
+
+        system_prompt += f"\n\n## Summary:\n{self.summary}\n\n## LinkedIn Profile:\n{self.linkedin}\n\n"
+        system_prompt += f"With this context, please chat with the user, always staying in character as {self.name}."
+        return system_prompt
+    
+    def chat(self, message, history):
+        messages = [{"role": "system", "content": self.system_prompt()}] + history + [{"role": "user", "content": message}]
+        done = False
+        while not done:
+            response = self.openai.chat.completions.create(model="gpt-4o-mini", messages=messages, tools=tools)
+            if response.choices[0].finish_reason=="tool_calls":
+                message = response.choices[0].message
+                tool_calls = message.tool_calls
+                results = self.handle_tool_call(tool_calls)
+                messages.append(message)
+                messages.extend(results)
+            else:
+                done = True
+        return response.choices[0].message.content
+    
+
+if __name__ == "__main__":
+    me = Me()
+    gr.ChatInterface(me.chat, type="messages").launch()
+    

env-example.txt

@@ -0,0 +1,8 @@
+# Copy this file to .env and fill in your actual values
+
+# OpenAI API Configuration (Required)
+OPENAI_API_KEY=your_openai_api_key_here
+
+# Pushover Notifications (Optional)
+PUSHOVER_TOKEN=your_pushover_token_here
+PUSHOVER_USER=your_pushover_user_key_here

me/summary.txt

@@ -0,0 +1,2 @@
+My name is Cedric Laridon. I'm a Belgian wealth-tech executive. 
+I’m a passionate pianist and composer, often immersing myself in Chopin, Bach, and my own classical and cinematic pieces. I have a deep love for culture, fine wine, and authentic dining experiences, and I enjoy traveling with my family to discover vibrant cities, music, and culinary scenes. I live by the idea of savoring life—whether that’s through music, food, or exploring new places—always seeking meaningful, authentic experiences over the mainstream.

pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "cedric-agent"
+version = "1.0.0"
+description = "Personal AI chatbot for Cedric Laridon's website"
+readme = "README.md"
+requires-python = ">=3.12"
+authors = [
+    {name = "Cedric Laridon", email = "cedric@example.com"}
+]
+license = {text = "MIT"}
+dependencies = [
+    "openai>=1.68.2",
+    "gradio>=5.22.0",
+    "python-dotenv>=1.0.1",
+    "pypdf>=5.4.0",
+    "requests>=2.32.3",
+]
+
+[tool.uv]
+dev-dependencies = []

requirements.txt

@@ -0,0 +1,5 @@
+openai>=1.68.2
+gradio>=5.22.0
+python-dotenv>=1.0.1
+pypdf>=5.4.0
+requests>=2.32.3

setup_check.py

@@ -0,0 +1,102 @@
+#!/usr/bin/env python3
+"""
+Setup verification script for Cedric Agent
+Checks if all dependencies are available and files are in place
+"""
+
+import sys
+import os
+import importlib
+
+def check_file_exists(filepath, description):
+    """Check if a file exists and print status"""
+    if os.path.exists(filepath):
+        print(f"✅ {description}: {filepath}")
+        return True
+    else:
+        print(f"❌ {description}: {filepath} - MISSING")
+        return False
+
+def check_module(module_name, description):
+    """Check if a Python module can be imported"""
+    try:
+        importlib.import_module(module_name)
+        print(f"✅ {description}: {module_name}")
+        return True
+    except ImportError:
+        print(f"❌ {description}: {module_name} - NOT INSTALLED")
+        return False
+
+def main():
+    print("🔍 Cedric Agent Setup Verification")
+    print("=" * 40)
+    
+    all_good = True
+    
+    # Check required files
+    print("\n📁 Checking files...")
+    files_to_check = [
+        ("app.py", "Main application"),
+        ("requirements.txt", "Dependencies file"),
+        ("pyproject.toml", "Project configuration"),
+        ("README.md", "Documentation"),
+        ("LICENSE", "License file"),
+        (".gitignore", "Git ignore file"),
+        ("me/summary.txt", "Personal summary"),
+        ("me/cedric-linkedin.pdf", "LinkedIn profile"),
+    ]
+    
+    for filepath, description in files_to_check:
+        if not check_file_exists(filepath, description):
+            all_good = False
+    
+    # Check Python modules
+    print("\n📦 Checking Python dependencies...")
+    modules_to_check = [
+        ("openai", "OpenAI library"),
+        ("gradio", "Gradio web interface"),
+        ("dotenv", "Environment variables"),
+        ("pypdf", "PDF processing"),
+        ("requests", "HTTP requests"),
+    ]
+    
+    for module_name, description in modules_to_check:
+        if not check_module(module_name, description):
+            all_good = False
+    
+    # Check environment variables
+    print("\n🔑 Checking environment variables...")
+    env_vars_to_check = [
+        ("OPENAI_API_KEY", "OpenAI API key", True),
+        ("PUSHOVER_TOKEN", "Pushover token", False),
+        ("PUSHOVER_USER", "Pushover user key", False),
+    ]
+    
+    for var_name, description, required in env_vars_to_check:
+        if os.getenv(var_name):
+            print(f"✅ {description}: Set")
+        else:
+            if required:
+                print(f"❌ {description}: NOT SET (Required)")
+                all_good = False
+            else:
+                print(f"⚠️  {description}: NOT SET (Optional)")
+    
+    # Final status
+    print("\n" + "=" * 40)
+    if all_good:
+        print("🎉 Setup verification completed successfully!")
+        print("You can now run: python app.py")
+    else:
+        print("❌ Setup verification failed!")
+        print("Please fix the issues above before running the application.")
+        
+        print("\n💡 Quick fixes:")
+        print("- Install missing dependencies: uv sync (or pip install -r requirements.txt)")
+        print("- Create .env file with your OpenAI API key")
+        print("- Make sure all files are in the correct location")
+    
+    return 0 if all_good else 1
+
+if __name__ == "__main__":
+    sys.exit(main())