Cài Đặt

Điều Kiện Tiên Quyết

• Git — Tải xuống và cài đặt Git, sau đó bật LFS:

  git lfs install

• VPN — Kết nối VPN của bạn (bắt buộc để truy cập các package registries bên ngoài và recipe server).

• uv — Cài đặt uv.

Các Bước

Bước 1. Tải xuống file .whl OV Hub mới nhất từ trang phát hành ov-hub-artifacts (hoặc yêu cầu file từ một thành viên của Overview.ai), sau đó cài đặt:

uv tool install --force ./ov_hub-<version>-py3-none-any.whl

Bước 2. Xác minh cài đặt:

ov-hub doctor

Việc một số kiểm tra bị lỗi ở giai đoạn này là bình thường — xác thực chưa được cấu hình và sẽ được hoàn tất ở bước sau.

Bước 3. Khởi động server OV Hub. Lựa chọn dựa trên vai trò của bạn:

• Chỉ xem và đồng bộ recipes:

  ov-hub serve

• Xuất bản các phiên bản recipe mới cho team:

  ov-hub serve --allow-publish-new-version

Bước 4. Mở http://localhost:8080/ và truy cập trang Settings. Thiết lập Name và Email của bạn. Đối với SSH Key, sử dụng key được cung cấp bởi team lead của bạn hoặc yêu cầu từ một thành viên của Overview.ai.

Bước 5. Tạo một thư mục cục bộ để sử dụng làm thư mục gốc cho các repository recipe của bạn. Trong Settings, nhập đường dẫn vào trường Default Clone Directory.

Giữ terminal luôn mở

OV Hub phải luôn chạy trong khi bạn làm việc — bao gồm cả trong quá trình tải lên và tải xuống ở chế độ nền. Không đóng terminal đang chạy server.