1
Tải file cài đặt
Bấm vào link bên dưới để tải AI Buddy for Teacher Setup 0.4.4.exe (~84 MB):
- File mặc định có tên
AI Buddy for Teacher Setup 0.4.4.exe — nếu trình duyệt đổi tên thành .exe.gz hoặc .download thì đổi lại đuôi .exe.
- Nếu Chrome/Edge cảnh báo "File này không tải xuống thường xuyên...", bấm mũi tên ▼ bên cạnh thông báo → chọn Keep (Giữ lại).
Phần mềm đã tích hợp sẵn LaTeX và TikZ — không cần cài đặt thêm bất kỳ thứ gì.
2
Mở file vừa tải
Sau khi tải xong:
- Double-click vào thông báo download ở góc dưới trình duyệt, hoặc mở thư mục Downloads (Tải xuống) → double-click file
.exe.
- Nếu phần mềm diệt virus (Kaspersky, Bitdefender, Avast, McAfee…) hiện cảnh báo, chọn Allow / Cho phép. Xem phần "Khắc phục lỗi" cuối hướng dẫn nếu antivirus xoá file.
3
Bỏ qua cảnh báo Windows SmartScreen
Đây là bước rất quan trọng! Windows sẽ hiện cảnh báo màu xanh vì phần mềm chưa được mua chứng chỉ ký số (code signing). Phần mềm KHÔNG phải virus.
Khi cửa sổ "Windows protected your PC" (Windows đã bảo vệ máy tính của bạn) hiện ra:
- Không bấm nút Don't run / Không chạy.
- Nhìn ở giữa cửa sổ, bấm vào dòng chữ nhỏ màu xanh "More info" / "Thông tin chi tiết".
- Cửa sổ sẽ mở rộng, hiển thị publisher là Unknown publisher và xuất hiện nút Run anyway / Vẫn chạy ở góc dưới bên phải — bấm vào nút đó.
- Từ lần thứ 2 mở file trở đi, Windows sẽ không còn hỏi nữa.
4
Chấp nhận quyền cài đặt (UAC)
Windows hỏi: "Do you want to allow this app to make changes to your device?" (Bạn có muốn cho phép ứng dụng này thay đổi thiết bị không?)
- Bấm Yes / Có.
- Nếu máy yêu cầu mật khẩu administrator (máy của trường, máy phòng tin học…), nhập mật khẩu admin của máy.
5
Chạy trình cài đặt
Cửa sổ "AI Buddy for Teacher Setup" hiện ra:
- Giữ thư mục cài mặc định (
C:\Users\<tên-bạn>\AppData\Local\Programs\AI Buddy for Teacher) hoặc đổi sang ổ D / ổ E nếu muốn.
- Tích "Create a desktop shortcut" nếu muốn shortcut ngoài Desktop, rồi bấm Install.
- Quá trình cài chạy khoảng 1–2 phút. Sau khi xong, bấm Finish — phần mềm sẽ tự mở.
6
(Tuỳ chọn) Cho phép Firewall
Bước này chỉ cần thiết khi tổ chức kỳ thi LAN. Nếu chỉ dùng TikZ to Image thì có thể bỏ qua.
- Lần đầu bấm "Bắt đầu" cho một kỳ thi, Windows Defender Firewall sẽ hỏi cho phép app truy cập mạng nội bộ.
- TÍCH chọn cả 2 ô Private networks (Mạng riêng) VÀ Public networks (Mạng công cộng) — WiFi lớp học có thể bị Windows nhận là public.
- Bấm Allow access / Cho phép truy cập.
- Lỡ bấm Cancel? Vào Settings → Privacy & Security → Windows Security → Firewall & network protection → Allow an app through firewall → tìm AI Buddy for Teacher và tick lại cả 2 ô.
7
Quay lại website để dùng TikZ to Image
Sau khi phần mềm đã chạy, quay lại trang này:
- Phần mềm chạy ngầm trên máy, website sẽ tự động kết nối qua
localhost.
- Kiểm tra trạng thái "Local server: online" ở khu vực soạn mã TikZ phía trên.
- Nhập mã TikZ và bấm Render — hình ảnh sẽ được render bằng LaTeX trên máy bạn.
Khi thấy chấm xanh "online", bạn đã sẵn sàng sử dụng!
Khắc phục các lỗi thường gặp
1. Antivirus xoá mất file .exe sau khi tải
Mở Windows Security → Virus & threat protection → Allowed threats → tìm AI Buddy for Teacher → bấm Restore. Hoặc tạm tắt antivirus rồi tải lại. Để lần sau không bị quét, thêm thư mục Downloads vào Exclusions.
2. Không cài được, báo "Permission denied" / "Access denied"
Click chuột phải vào file .exe → Run as administrator → Yes. Nếu vẫn lỗi, đăng nhập bằng tài khoản admin của máy rồi cài lại.
3. Học sinh không truy cập được IP máy giáo viên (khi tổ chức kỳ thi LAN)
Kiểm tra theo thứ tự: (1) máy giáo viên và học sinh cùng WiFi, (2) đã Allow Firewall ở bước 6, (3) thử tắt VPN / chương trình proxy, (4) mở Command Prompt và chạy ipconfig để xem đúng IPv4 hiện đang dùng.
4. Mở app báo "Application failed to start" hoặc lỗi DLL
Cài Microsoft Visual C++ Redistributable mới nhất từ aka.ms/vs/17/release/vc_redist.x64.exe, khởi động lại Windows rồi mở lại phần mềm.
5. Đã cài rồi nhưng website vẫn báo "Local server: offline"
Kiểm tra: (1) phần mềm có đang mở không (xem khay hệ thống ở góc dưới phải Windows), (2) thử mở http://localhost:8088/health trong trình duyệt — phải thấy chữ {"ok": true}. Nếu không phải tắt antivirus đang chặn cổng 8088, hoặc khởi động lại phần mềm.