Skip to content

Latest commit

 

History

History
290 lines (188 loc) · 9.5 KB

README.md

File metadata and controls

290 lines (188 loc) · 9.5 KB
Raw

🤖 Loki - Trợ lý AI Messenger Nâng cao

Loki là một chatbot Facebook Messenger tiên tiến được xây dựng bằng Python, tích hợp Selenium và các khả năng AI mạnh mẽ.

Typing SVG

👨‍💻 Developed with ❤️ by tanbaycu

Profile views


Building smarter conversations, one message at a time ✨

🌟 Tính năng chính

1. Tích hợp Messenger tự động

  • Đăng nhập tự động với xử lý xác thực hai lớp
  • Theo dõi tin nhắn và hình ảnh mới trong thời gian thực
  • Gửi tin nhắn văn bản và hình ảnh một cách linh hoạt

2. Tích hợp AI thông minh

  • Sử dụng Google Gemini AI để tạo phản hồi thông minh
  • Xử lý ngôn ngữ tự nhiên để hiểu ngữ cảnh và ý định
  • Phân tích hình ảnh thông qua Gemini Vision

3. Đa ngôn ngữ

  • Hỗ trợ hơn 20 ngôn ngữ với chuyển đổi liền mạch
  • Dịch tự động các phản hồi và thông báo hệ thống
  • Lưu trữ bộ nhớ cache dịch để tối ưu hiệu suất

4. Quản lý bộ nhớ thông minh

  • Lưu trữ lịch sử trò chuyện dài hạn bằng JSON
  • Tóm tắt cuộc trò chuyện theo khoảng thời gian
  • Tự động dọn dẹp bản ghi cũ để tối ưu hóa bộ nhớ

5. Xử lý hình ảnh nâng cao

  • Tối ưu hóa hình ảnh tự động trước khi gửi
  • Tạo thư viện ảnh từ tìm kiếm Unsplash
  • Lưu trữ và quản lý hình ảnh tạm thời hiệu quả

6. Tích hợp công cụ đa dạng

  • Rút gọn URL và tạo mã QR
  • Phân tích và theo dõi lịch sử URL
  • Tạo và giải thích mã nguồn cho nhiều ngôn ngữ lập trình

7. Tính năng giải trí

  • Trò chơi nối từ tương tác với AI
  • Chế độ facts ngẫu nhiên từ nhiều nguồn
  • Tìm kiếm và định dạng công thức nấu ăn

8. Khả năng tương tác bằng giọng nói

  • Chuyển đổi văn bản thành giọng nói
  • Xử lý lệnh giọng nói (đang phát triển)

🛠️ Kiến trúc kỹ thuật

Cấu trúc lớp chính

  1. FacebookLogin

    • Xử lý quá trình đăng nhập cơ bản
    • Quản lý cookie phiên
    • Triển khai kiểm tra xác minh

  2. LoginCreateSession (kế thừa FacebookLogin)

    • Cấu hình trình duyệt chi tiết
    • Điều hướng trang và xử lý thông báo

  3. Listener (kế thừa LoginCreateSession)

    • Theo dõi tin nhắn và hình ảnh mới
    • Xử lý sự kiện đầu vào

  4. Sender (kế thừa Listener)

    • Gửi tin nhắn văn bản và hình ảnh
    • Định dạng tin nhắn cho Messenger

  5. MesChat (kế thừa Sender)

    • Lớp chính kết hợp tất cả chức năng
    • Xử lý lệnh và luồng hội thoại
    • Tích hợp AI và công cụ bổ sung

Các thành phần quan trọng

  • Quản lý bộ nhớ: Sử dụng JSON để lưu trữ
  • Xử lý lỗi: Bắt và báo cáo lỗi toàn diện
  • Giới hạn tốc độ: Cơ chế thử lại thông minh
  • Dọn dẹp tài nguyên: Quản lý file tạm tự động

🚀 Cài đặt và cấu hình

Yêu cầu hệ thống

  • Python 3.8+
  • Google Chrome hoặc Chromium
  • ChromeDriver tương thích

Thư viện Python cần thiết

pip install selenium google-translator requests pillow colorama psutil emoji google-generativeai

Biến môi trường

GEMINI_API_KEY = "your_gemini_api_key"
GITHUB_TOKEN = "your_github_token"
UNSPLASH_ACCESS_KEY = "your_unsplash_access_key"

Cách sử dụng cơ bản

bot = MesChat(
    email_or_phone="your_facebook_email",
    password="your_facebook_password",
    group_or_chat="https://www.messenger.com/t/your_chat_id"
)

bot.start()

🎮 Lệnh có sẵn

Lệnh chung

  • /language [mã]: Thay đổi ngôn ngữ bot
  • /summary [khoảng thời gian]: Nhận tóm tắt cuộc trò chuyện
  • /clear: Xóa lịch sử trò chuyện
  • /help: Hiển thị tin nhắn trợ giúp
  • /guide: Hiển thị hướng dẫn chi tiết

Lệnh công cụ

  • /short [url]: Rút gọn URL
  • /qr [nội dung]: Tạo mã QR
  • /analyze [url]: Phân tích URL
  • /urlhistory: Xem lịch sử công cụ URL

AI & Giải trí

  • /code [ngôn ngữ] [yêu cầu]: Tạo mã
  • /noitu [từ]: Bắt đầu trò chơi nối từ
  • /voice [văn bản]: Chuyển văn bản thành giọng nói
  • /recipe [truy vấn]: Tìm kiếm công thức nấu ăn
  • /fact: Bật chế độ fact ngẫu nhiên
  • /image [truy vấn]: Tìm kiếm và tạo thư viện ảnh

🔧 Tính năng nâng cao

Quản lý bộ nhớ

  • Lưu trữ JSON: Sử dụng json để lưu và tải lịch sử
  • Tóm tắt thông minh: Sử dụng Gemini AI để tạo tóm tắt
  • Giới hạn kích thước: Tự động cắt bớt khi vượt quá max_memory_size

Xử lý lỗi và thử lại

  • Đăng nhập: Thử lại tự động với login_twice()
  • API Gemini: Thử lại với thời gian chờ tăng dần
  • Gửi hình ảnh: Cơ chế thử lại trong attempt_send_image()

Tối ưu hóa hiệu suất

  • Nén hình ảnh: Sử dụng Pillow để tối ưu hóa trước khi gửi
  • Bộ nhớ cache dịch: Lưu trữ bản dịch để tái sử dụng
  • Dọn dẹp tài nguyên: Xóa file tạm và giới hạn số lượng ảnh lưu trữ

🧠 Tích hợp AI

Google Gemini

  • Sử dụng mô hình gemini-1.5-flash-8b-latest cho phản hồi nhanh
  • Xử lý cả văn bản và hình ảnh đầu vào
  • Tùy chỉnh nhiệt độ và tham số sinh cho đầu ra đa dạng

Xử lý ngôn ngữ tự nhiên

  • Phân tích ý định người dùng từ tin nhắn đầu vào
  • Tạo phản hồi tự nhiên và phù hợp ngữ cảnh
  • Hỗ trợ đa ngôn ngữ với dịch tự động

Phân tích hình ảnh

  • Sử dụng Gemini Vision để mô tả và phân tích hình ảnh
  • Tích hợp với chức năng tìm kiếm và tạo thư viện ảnh

🎨 Xử lý hình ảnh

Tối ưu hóa

def handle_image(self, img_path):
    with Image.open(img_path) as img:
        max_size = (1280, 1280)
        img.thumbnail(max_size, Image.LANCZOS)
        img.save(temp_filename, quality=85, optimize=True)

Tạo thư viện ảnh

  • Sử dụng API Unsplash để tìm kiếm ảnh chất lượng cao
  • Tạo gallery trên Telegra.ph với 20 ảnh được lọc
  • Sắp xếp ảnh theo số lượt thích để đảm bảo chất lượng

🔐 Bảo mật

  • Sử dụng biến môi trường cho khóa API nhạy cảm
  • Xử lý an toàn thông tin đăng nhập Facebook
  • Giới hạn quyền truy cập vào chức năng nhạy cảm

🐛 Gỡ lỗi và khắc phục sự cố

Vấn đề thường gặp

  1. Lỗi đăng nhập: Kiểm tra thông tin đăng nhập và cài đặt bảo mật Facebook
  2. Giới hạn API: Thực hiện độ trễ phù hợp giữa các yêu cầu
  3. Vấn đề bộ nhớ: Giám sát và dọn dẹp file tạm thường xuyên

📚 Tài nguyên bổ sung

🤝 Đóng góp

Chúng tôi hoan nghênh mọi đóng góp! Vui lòng gửi issues và pull requests.

Đọc thêm tại đây

Hướng dẫn toàn diện