Claude.md

🎭 AI Friends Talk

Cuộc nói chuyện vui vẻ giữa 3 người bạn AI với tính cách khác nhau!

👥 Nhân vật

• 🎭 Alex (Groq llama3-70b-8192): Dí dỏm, châm biếm, thích chơi chữ
• 🌟 Blake (Gemini 2.0 Flash): Lạc quan, nhiệt tình, thích chia sẻ
• 🧠 Charlie (Gemini 1.5 Flash): Triết lý, suy nghĩ sâu sắc, là người hòa giải

🚀 Cách sử dụng

1. Cài đặt dependencies

pip install -r requirements_ai_talk.txt

2. Cấu hình API keys

1. Copy file .env.example thành .env
2. Thêm API keys của bạn:
   • GROQ_API_KEY: Tạo tại https://console.groq.com/
   • GOOGLE_API_KEY: Tạo tại https://ai.google.dev/gemini-api

3. Chạy ứng dụng

python AI_Talk.py

4. Sử dụng giao diện

1. Chọn ngôn ngữ mong muốn (English/Tiếng Việt/Deutsch)
2. Chọn chủ đề từ danh sách hoặc tạo chủ đề riêng
3. Click "🚀 Start New Conversation" để bắt đầu
4. Nhập tin nhắn của bạn và click "📝 Add Your Message" để tham gia cuộc trò chuyện
5. Click "💬 Continue Conversation" để 3 bạn AI tiếp tục trò chuyện
6. Lặp lại bước 4-5 để cuộc trò chuyện tiếp diễn!

🎯 Tính năng

• 3 AI khác nhau: Mỗi nhân vật có tính cách riêng biệt
• Đa ngôn ngữ: Hỗ trợ 3 ngôn ngữ với cờ quốc gia đẹp mắt (🇺🇸 English, 🇻🇳 Tiếng Việt, 🇩🇪 Deutsch)
• Chủ đề đa dạng: Dropdown chủ đề gợi ý + textbox tùy chỉnh chủ đề riêng
• Giao diện premium: Thiết kế gradient đẹp mắt, animation, không có khoảng trống
• Hero section: Phần giới thiệu có hình ảnh chuyển động, thông tin nhân vật
• Tương tác người dùng: Hộp chat để bạn người sử dụng tham gia cuộc trò chuyện
• Status feedback: Thông báo trạng thái real-time với màu sắc đẹp mắt
• Responsive design: Tối ưu cho mọi thiết bị
• Tương thích Hugging Face: Có thể deploy trực tiếp lên Spaces

🎭 Chủ đề mẫu

Tiếng Việt:

• "Hot dog có phải là sandwich không?"
• "Nếu người ngoài hành tinh đến Trái Đất, điều gì sẽ khiến họ bối rối nhất?"
• "Ngũ cốc có phải là soup không?"
• "Siêu năng lực nào sẽ vô dụng nhất trong đời sống hàng ngày?"
• "Nếu động vật biết nói chuyện, loài nào sẽ bất lịch sự nhất?"

English:

• "Whether hot dogs are sandwiches or not"
• "If aliens visited Earth, what would confuse them most about humans?"
• "The eternal debate: Is cereal soup?"
• "Which superpower would be most useless in daily life?"
• "If animals could talk, which would be the rudest?"

Deutsch:

• "Sind Hotdogs Sandwiches oder nicht?"
• "Wenn Außerirdische die Erde besuchen würden, was würde sie am meisten verwirren?"
• "Die ewige Debatte: Ist Müsli eine Suppe?"
• "Welche Superkraft wäre im Alltag am nutzlosesten?"
• "Wenn Tiere sprechen könnten, welche wären am unhöflichsten?"

Bổ sung thêm chủ đề để làm phong phú thêm nội dung trò chuyện

🔧 Cấu trúc code

• AITalk class: Quản lý cuộc trò chuyện và API calls
• Character personalities: Mỗi AI có system prompt riêng
• Gradio interface: Giao diện web tương tác
• Error handling: Xử lý lỗi API gracefully

🌐 Deploy lên Hugging Face Spaces

1. Tạo Space mới trên https://huggingface.co/spaces
2. Upload các file: AI_Talk_Gradio.py, requirements_ai_talk.txt
3. API keys file .env
4. Space sẽ tự động chạy!

📝 Ghi chú

• Dựa trên cấu trúc của day1.ipynb, AI_Talk.py.
• Sử dụng OpenAI-compatible interface cho Gemini
• Conversation context được giới hạn 10 tin nhắn gần nhất để tối ưu hiệu suất
• Mỗi response được giới hạn 150 tokens để giữ cuộc trò chuyện sống động

🐛 Troubleshooting

• API Key errors: Kiểm tra file .env và keys hợp lệ
• Model not available: Một số model có thể bị giới hạn khu vực
• Rate limiting: Đợi một chút giữa các request
• Connection errors: Kiểm tra kết nối internet

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

• Có banner phía dưới vừa đủ để che phần nội dung 'Build with Gradio', có thiết kế đẹp mắt phù hợp với ngữ cảnh.
• Nút 'Continue' và 'Clear' đặt lại phía dưới của conversation, chia làm 2 cột.