Rag Document Pro - Hướng dẫn cài đặt từ A-Z

Tài liệu này hướng dẫn bạn các bước thiết lập từ lúc clone dự án cho đến khi khởi chạy ứng dụng hoàn chỉnh.

Đầu tiên, bạn cần clone project này về máy hoặc Server:

git clone https://github.com/NhoThoang/Rag_doccument_pro.git
cd Rag_doccument_pro

Mở terminal WSL của bạn và chạy các lệnh sau:

# Cập nhật danh sách gói
sudo apt update

# Cài đặt công cụ 'make'
sudo apt install make -y

Sử dụng Makefile để tự động cài đặt môi trường:

make install

LƯU Ý QUAN TRỌNG: Sau khi cài xong, bạn BẮT BUỘC phải đóng Terminal WSL và mở lại, hoặc chạy lệnh newgrp docker để quyền truy cập Docker có hiệu lực ngay lập tức mà không cần khởi động lại session.

# Tạo network cho ứng dụng
make network

# Khởi chạy toàn bộ dịch vụ (Postgres, Redis, Qdrant, Minio, v.v.)
make up

• Trạng thái container: make ps
• Xem logs: make logs
• Dừng ứng dụng: make down
• Khởi động lại: make restart

Sau khi hệ thống phía Server đã chạy (make up thành công), bạn tiến hành cài đặt giao diện người dùng:

1. Tải ứng dụng tại đây:

   • Windows: Install_rag_documents.exe (v1.0.1)
   • macOS: Rag_documents-macos-latest.zip
   • Ubuntu: Rag_documents-ubuntu-latest.zip

2. Hướng dẫn khởi chạy (macOS & Ubuntu):

   • Tải file .zip tương ứng và giải nén.
   • Mở file config/db_config.json và cấu hình các thông số Database (khớp với file .env phía Server):
     • host, port, user, password, database.
   • Chạy file thực thi Rag_documents (có thể cần cấp quyền thực thi: chmod +x Rag_documents).

3. Hướng dẫn khởi chạy (Windows):

   • Mở ứng dụng và điền các thông số kết nối trực tiếp trên giao diện:
     • POSTGRES_DB: dongybiphap
     • POSTGRES_USER: dongybiphap
     • POSTGRES_PASSWORD: kmhd16061994
     • POSTGRES_HOST: localhost (hoặc IP server/WSL của bạn)
     • POSTGRES_PORT: 5432
   • Bấm Connect để ứng dụng tiến hành kết nối, cài đặt và khởi tạo các bảng dữ liệu cần thiết.

Dưới đây là một số hình ảnh thực tế của ứng dụng:

Ảnh 1: Giao diện chọn tài liệu để tiến hành xử lý chunking.

Ảnh 2: Giao diện quản lý người dùng, trạng thái server và bật/tắt Cloudflare Tunnel.

Ảnh 3: Các thiết lập chung cho toàn bộ ứng dụng.

Ảnh 4: Tiến trình Embedding các file đã được chunk ở Bước 4.1.

Ảnh 5: Các tùy chỉnh và thiết lập cho AI Agent.

Chúc bạn cài đặt thành công!