README_Deploy.md

AI Friends Talk - Gradio Deployment Guide

🎭 Watch 3 AI friends with different personalities debate fun topics!

🚨 IMPORTANT: Deployment Error Fix

If you get the error "It appears that one or more of your files contain valid Hugging Face secrets", follow these steps:

For Hugging Face Spaces Deployment (CORRECT WAY)

Method 1: Manual Upload (Recommended)

1. Create a new Space at https://huggingface.co/spaces

2. Upload ONLY these files:

   • AI_Talk_Gradio.py
   • requirements.txt
   • .gitignore (optional)

3. DO NOT upload these files:

   • ❌ .env (contains API keys)
   • ❌ __pycache__/ folders
   • ❌ .gradio/ folders
   • ❌ Certificate files (.pem)

4. Add API keys as Secrets in Space settings:

   • Go to your Space → Settings → Repository secrets
   • Add: GROQ_API_KEY = your_groq_api_key
   • Add: GOOGLE_API_KEY = your_google_api_key

5. Space will auto-deploy with the secrets!

Method 2: Using huggingface_hub (Advanced)

from huggingface_hub import HfApi

api = HfApi()
api.upload_file(
    path_or_fileobj="AI_Talk_Gradio.py",
    path_in_repo="AI_Talk_Gradio.py", 
    repo_id="your_username/your_space_name",
    repo_type="space"
)
api.upload_file(
    path_or_fileobj="requirements.txt",
    path_in_repo="requirements.txt",
    repo_id="your_username/your_space_name", 
    repo_type="space"
)

For Local Development

1. Install dependencies:

pip install -r requirements.txt

2. Create .env file:

GROQ_API_KEY=your_groq_api_key_here
GOOGLE_API_KEY=your_google_api_key_here

3. Run the app:

python AI_Talk_Gradio.py

🤖 AI Characters

• 🎭 Alex (Groq llama3-70b): Witty debater
• 🌟 Blake (Gemini 2.0): Creative optimist
• 🧠 Charlie (Gemini 1.5): Logical analyst

✨ Features

• 🌐 Multi-language support (English/Tiếng Việt/Deutsch)
• 🎯 Custom or predefined topics
• 💬 Join the conversation as 4th participant
• 🎨 Beautiful gradient UI with animations
• 📱 Mobile responsive design
• 🔄 Auto-conversation flow
• ⚡ Real-time AI responses

📁 Files Structure for Deployment

AI_Game/
├── AI_Talk_Gradio.py      ✅ Main app file
├── requirements.txt       ✅ Dependencies
├── .gitignore            ✅ Ignore sensitive files
├── README_Deploy.md      ℹ️  This guide
├── .env                  ❌ DO NOT UPLOAD (contains secrets)
└── __pycache__/          ❌ DO NOT UPLOAD (Python cache)

🔑 API Keys Required

1. Groq API Key: Get from https://console.groq.com/
2. Google API Key: Get from https://ai.google.dev/gemini-api

🔧 Troubleshooting

• "BadRequestError: secrets detected": Remove .env file from upload
• "Model not found": Check API keys in Space secrets
• "Port already in use": App auto-selects available port
• Import errors: Verify requirements.txt is uploaded

Made by Digitized Brains 🧠