Trang 2.1: Yêu cầu hệ thống (Chi tiết về phiên bản Node.js >= 16 và Python >= 3.10).

1. Tóm tắt yêu cầu

Trước khi cài đặt Antigravity Kit, hãy đảm bảo máy tính của bạn đã đáp ứng các yêu cầu tối thiểu sau:

2. Node.js

Tại sao cần Node.js?

Công cụ dòng lệnh ag-kit được xây dựng trên nền tảng Node.js. Bạn cần Node.js để:

• Chạy lệnh npx @vudovn/ag-kit init để cài đặt bộ kit.
• Sử dụng lệnh ag-kit nếu cài đặt toàn cục.

Kiểm tra phiên bản Node.js

Mở Terminal (Command Prompt / PowerShell) và chạy:

bash
node --version

Kết quả hợp lệ phải hiển thị phiên bản >= 16.0, ví dụ: v20.11.0.

Cài đặt Node.js

Nếu chưa có, tải và cài đặt từ trang chính thức:

• Khuyến nghị: nodejs.org — Chọn phiên bản LTS (Long Term Support) để đảm bảo ổn định.

Mẹo: Nên cài đặt phiên bản Node.js LTS mới nhất (hiện tại là Node.js 20.x LTS) để có sự tương thích tốt nhất với tất cả các gói npm hiện đại.

3. Python

Tại sao cần Python?

Các script kiểm tra chất lượng tự động của Antigravity Kit (checklist.py, verify_all.py) và nhiều script con trong từng Skill đều được viết bằng Python. Để các tính năng tự động hóa hoạt động, Python phải:

1. Được cài đặt trên máy tính.
2. Có thể gọi bằng lệnh python (hoặc python3) từ bất kỳ vị trí nào trong Terminal.

Kiểm tra phiên bản Python

python --version

Kết quả hợp lệ phải hiển thị phiên bản >= 3.10, ví dụ: Python 3.12.1.

Cài đặt Python (Windows)

Lưu ý quan trọng (Windows): Nếu bỏ qua bước tích chọn "Add Python to PATH", lệnh python sẽ không được nhận dạng và các script kiểm tra của Kit sẽ không hoạt động. Bạn có thể khắc phục bằng cách gỡ cài đặt và cài lại Python với tùy chọn đó.

Cài đặt Python (macOS / Linux)

# macOS (dùng Homebrew)
brew install python3

# Ubuntu / Debian
sudo apt update && sudo apt install python3 python3-pip

4. Git

Tại sao cần Git?

• Lệnh ag-kit update dùng Git để tải phiên bản mới nhất của bộ kit từ GitHub.
• Cho phép bạn commit thư mục .agent/ vào repository của dự án để chia sẻ cấu hình với cả đội.

Kiểm tra phiên bản Git

bash
git --version

Kết quả hợp lệ ví dụ: git version 2.43.0.

Cài đặt Git

• Windows: Tải từ git-scm.com.
• macOS: Chạy brew install git hoặc cài Xcode Command Line Tools.
• Linux: sudo apt install git (Ubuntu/Debian) hoặc sudo dnf install git (Fedora).

5. Kiểm tra nhanh toàn bộ hệ thống

Chạy các lệnh sau để kiểm tra tất cả thành phần cùng lúc:

node --version   # Kiểm tra Node.js
npm --version    # Kiểm tra npm
python --version # Kiểm tra Python
git --version    # Kiểm tra Git

Nếu tất cả đều trả về số phiên bản hợp lệ, hệ thống của bạn đã sẵn sàng để cài đặt Antigravity Kit.

6. Hệ điều hành được hỗ trợ

Antigravity Kit tương thích với tất cả các hệ điều hành phổ biến:

Sau khi đảm bảo đủ các yêu cầu trên, hãy chuyển sang Trang 2.2: Hướng dẫn cài đặt nhanh để tiến hành cài đặt Antigravity Kit vào dự án của bạn.