Công cụ chụp ảnh màn hình giải trắc nghiệm tự động, phân tích hình ảnh và trả về kết quả đáp án trực tiếp trên màn hình nền dưới dạng Overlay cực đẹp mắt.
Desktop Client (Screenshot AI Answer) chạy nền tích hợp hotkey. Khi thi trắc nghiệm, bạn chỉ cần nhấn phím tắt, kéo chọn vùng câu hỏi, hệ thống sẽ sử dụng công cụ dòng lệnh Antigravity CLI (agy) (và Tesseract OCR) để phân tích thông qua một Console ảo (PTY), sau đó kết xuất riêng đáp án (A/B/C/D) lơ lửng trên góc màn hình một cách vô cùng tiện lợi và tinh tế mà không bị lộ các cửa sổ UI chat khác.
- 📸 Chụp màn hình thông minh: Nhấn phím tắt để kéo dãn chọn vùng màn hình nhanh chóng.
- 🎯 Trích xuất chữ (OCR) & Trợ lý thông minh: Hoạt động kết hợp với Tesseract OCR để nhận diện chữ trong ảnh, và đẩy lên mô hình phân tích qua CLI.
- ⚡ Overlay siêu tốc: Hiển thị riêng chữ cái đáp án (A, B, C, D) lơ lửng trên màn hình (Overlay), không chặn click chuột, không cản trở thao tác thi.
- ⚙️ Chế độ chạy ẩn (Stealth process): Hỗ trợ chạy background không có khung đen Terminal thông qua
main.pyw.
- Hệ điều hành: Windows 10/11
- Môi trường: Python 3.10 trở lên
- Phụ thuộc cốt lõi: Công cụ
agy(Antigravity CLI) có khả dụng trong PATH. - Tesseract OCR: Cần được cài đặt sẵn trên hệ thống Windows để trích xuất text chữ.
# Clone mã nguồn
git clone https://github.com/hungvu25/Cheat-Exam.git
cd Cheat-Exam
# Cài đặt thư viện Python (bao gồm chuột/phím, hình ảnh và Terminal ảo PTY)
pip install -r requirements.txtVì Tool hoạt động ngầm thông qua CLI và trích chữ trực tiếp từ màn hình nên cần 2 ứng dụng sau hoạt động trên Máy Windows:
Cài đặt Antigravity CLI (agy):
- Mở PowerShell với quyền Administrator và chạy lệnh sau để tự động tải & cài đặt:
(Hoặc nếu dùng cửa sổ CMD thông thường):
irm https://antigravity.google/cli/install.ps1 | iex
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
- Đăng nhập một lần duy nhất (Bắt buộc): Mở terminal của bạn và chạy lệnh sau:
Trình duyệt sẽ tự động mở trang đăng nhập Google OAuth. Bạn tiến hành đăng nhập bằng tài khoản Google để kích hoạt CLI. Sau khi kích hoạt thành công, bạn có thể đóng terminal lại.
agy
Cài đặt Tesseract OCR:
- Tải bộ cài Tesseract OCR dành cho Windows tại: UB-Mannheim Tesseract (Khuyên dùng bản 64-bit mới nhất).
- Chạy trình cài đặt và làm theo hướng dẫn (bên trong mục lựa chọn Additional language data, có thể tick chọn
Vietnamesenếu nhận diện tiếng Việt). - Quan trọng: Thêm đường dẫn
C:\Program Files\Tesseract-OCRvào biến môi trường PATH của Windows.
Mở file mã nguồn config.py ra và chỉnh sửa thông số cho hợp ý của bạn:
# Tên model chạy trên Antigravity CLI (mặc định là "gemini-3.5-flash")
ANTIGRAVITY_CLI_MODEL = "gemini-3.5-flash"
# Phím tắt của tool để chạy chọn vùng
DEFAULT_HOTKEY = "z"Không cần phải lấy Cookie từ trình duyệt hay tạo file .env rườm rà. Hệ thống sẽ kết xuất thẳng lên tool!
Bạn có thể khởi chạy Desktop Tool từ thư mục dự án qua 2 cách tùy kịch bản:
Chế độ hiển thị Terminal (Để theo dõi tiến độ log xử lý hoặc xem lỗi nếu có):
python main.pyChế độ chạy ngầm (Không hiện bất kì cửa sổ đen Console nào - Lựa chọn số 1 khi làm bài):
python main.pyw- Nhấn phím
Z(hoặc tổ hợp phím bạn đã config) và dùng chuột khoanh vùng câu hỏi trắc nghiệm (bao gồm cả các đáp án để AI đọc). - Tool sẽ tốn 2-4s xử lý và bung ảnh chữ nổi A, B, C, D ra mép màn hình.
- Phím
Esc: Hủy lập tức đáp án nổi trên màn hình.
📦 Cheat-Exam
┣ 📜 config.py # File cấu hình trung tâm (Hotkey, kích thước...)
┣ 📜 ai_client.py # Xử lý Logic ảnh & giao tiếp lệnh đến AI
┣ 📜 main.py / main.pyw # Trình khởi chạy Tool có / không có Console
┣ 📜 overlay.py # Xử lý Giao diện đáp án lơ lửng màn hình
┣ 📜 screenshot.py # Script trích hình tọa độ con trỏ (mss & Pillow)
┗ 📜 requirements.txt # Chứa các gói python phụ trợ Overlay / OCR
- License: Vui lòng tham khảo License gốc để biết thêm cấu trúc phân phối.
- Mọi đóng góp Pull Request giúp tính năng bắt điểm OCR nét hơn hoặc tăng tốc CLI đều vô cùng mong chờ.
💖 Nếu dự án mang lại trải nghiệm thi cử siêu mượt và an toàn, hãy tặng kho lưu trữ một nhấp Star ⭐ khích lệ nhé!