README_Gradio.md

🤖 AI Friends Talk - Gradio Version

Cuộc nói chuyện vui vẻ giữa 3 người bạn AI với giao diện Gradio!

🎯 Tính năng

• 3 AI Characters: Alex (Groq), Blake (Gemini 2.0), Charlie (Gemini 1.5)
• Giao diện Gradio: Web interface hiện đại, dễ sử dụng
• Đa ngôn ngữ: English, Tiếng Việt, Deutsch
• Chủ đề đa dạng: 20+ chủ đề có sẵn + tùy chỉnh
• Tương tác real-time: Tham gia cuộc trò chuyện với AI
• Deploy friendly: Dễ deploy lên Hugging Face Spaces
• Thiết kế đẹp: Custom footer che Gradio attribution
• UI tối ưu: Controls được tổ chức hợp lý, dễ sử dụng

🚀 Cách sử dụng

1. Cài đặt dependencies

pip install -r requirements_ai_talk_gradio.txt

2. Cấu hình API keys

Tạo file .env với nội dung:

GROQ_API_KEY=your_groq_api_key_here
GOOGLE_API_KEY=your_google_api_key_here

3. Chạy ứng dụng

Cách 1: Sử dụng script

start_ai_talk.bat

Cách 2: Chạy trực tiếp

python AI_Talk_Gradio.py

4. Truy cập giao diện

• Mở browser và truy cập: http://localhost:7860
• Hoặc sử dụng share link được tạo tự động

📱 Hướng dẫn sử dụng

1. Chọn ngôn ngữ: Dropdown đầu trang
2. Chọn chủ đề: Từ danh sách có sẵn hoặc nhập tùy chỉnh
3. Bắt đầu: Click "🎬 Start Conversation"
4. Theo dõi: Xem cuộc trò chuyện diễn ra
5. Điều khiển: Sử dụng các nút bên dưới conversation:
   • ▶️ Continue: AI tiếp tục trò chuyện
   • 🔄 Clear: Xóa để bắt đầu lại
6. Tham gia: Nhập tin nhắn và click "📤 Send" để join cuộc trò chuyện

🎭 Nhân vật AI

• 🎭 Alex: Người tranh luận dí dỏm (Groq Llama3-70B)
• 🌟 Blake: Người lạc quan sáng tạo (Gemini 2.0 Flash)
• 🧠 Charlie: Nhà phân tích logic (Gemini 1.5 Flash)

🌐 Deploy lên Hugging Face Spaces

1. Tạo Space mới: https://huggingface.co/spaces
2. Upload các file:
   • AI_Talk_Gradio.py
   • requirements_ai_talk_gradio.txt
   • .env (với API keys)
3. Space sẽ tự động chạy!

📝 Files quan trọng

• AI_Talk_Gradio.py: Main application (cần API keys)
• AI_Talk_Demo.py: Demo version (không cần API keys)
• requirements_ai_talk_gradio.txt: Dependencies
• start_ai_talk.bat: Windows startup script
• .env: API keys configuration

🎨 Thiết kế mới

• Footer tùy chỉnh: Che đi "Built with Gradio" với banner Digitized Brains
• Controls tối ưu: Nút Continue/Clear được đặt bên dưới conversation
• Layout hợp lý: Start button độc lập, các controls phân tách rõ ràng
• CSS gradient: Thiết kế đẹp mắt với màu sắc phù hợp

🐛 Troubleshooting

Lỗi Import:

pip install -r requirements_ai_talk_gradio.txt

API Key Error: Kiểm tra file .env và API keys hợp lệ

Port đã được sử dụng: Đổi port trong code hoặc kill process đang chạy

Unicode Error: File đã được optimize cho Windows console

💡 So sánh với phiên bản Streamlit

Tính năng	Streamlit	Gradio
Giao diện	Custom CSS phức tạp	Components sẵn có
Deploy	Streamlit Cloud	HuggingFace Spaces
Performance	Reload nhiều	Ít reload hơn
Customization	Cao	Trung bình
Ease of use	Trung bình	Dễ

Chúc bạn có những cuộc trò chuyện vui vẻ! 🎉