Cài đặt & tự cập nhật

Cài app

1. Vào trang Releases của repo PixGamma, tải PixGamma-<phiên bản>.dmg (các bản đến 0.2.1 có tên cũ Pixora-<phiên bản>.dmg).
2. Mở file DMG, kéo PixGamma vào Applications.
3. Lần đầu mở: chuột phải vào PixGamma trong Applications → Open → Open. App được ký ad-hoc, chưa qua notarize của Apple, nên macOS hỏi xác nhận một lần.
4. Muốn dùng lệnh pixgamma trong Terminal: trong DMG, bấm đúp Cài lệnh pixgamma (CLI).command. Lệnh được link vào /opt/homebrew/bin, /usr/local/bin hoặc ~/.local/bin.

Nếu macOS báo ứng dụng "bị hỏng" hoặc không cho mở, chạy một lần:

xattr -dr com.apple.quarantine /Applications/PixGamma.app

DMG đã có sẵn mọi model phóng ảnh (khoảng 650 MB). Lần chạy đầu Core ML compile model cho máy nên chậm hơn vài chục giây, các lần sau nhanh.

Tự cập nhật

PixGamma tự kiểm tra bản mới mỗi ngày một lần; kiểm tra ngay ở menu PixGamma → Kiểm tra cập nhật… Khi có bản mới, app hiện ghi chú phát hành, tải DMG, kiểm tra mã SHA-256, kiểm tra đúng bundle id và số phiên bản, thay app (giữ bản cũ để hoàn tác nếu chép lỗi) rồi tự mở lại.

Repo PixGamma là riêng tư nên lần đầu app cần một token GitHub chỉ đọc, cất trong Keychain của máy:

1. Tạo Fine-grained token trên GitHub.
2. Repository access: chỉ chọn repo PixGamma. Permissions → Contents: Read-only.
3. Dán token vào hộp thoại cập nhật của app.

Từ Terminal:

Lệnh	Việc
pixgamma update	Kiểm tra bản mới
pixgamma update --install	Tải và cài (đóng app trước)
pixgamma update --token <token>	Lưu token vào Keychain

Biến môi trường PIXGAMMA_GITHUB_TOKEN dùng thay Keychain cho script.

Model Recover (tùy chọn)

Recover dùng diffusion, bộ model nặng khoảng 2,7 GB nên tách khỏi DMG thành hai file zip (giới hạn 2 GB mỗi file của GitHub Releases):

1. Tải PixGamma-Recover-<phiên bản>-1.zip và -2.zip vào thư mục Downloads (bản đến 0.2.1: Pixora-Recover-…).
2. Trong DMG, bấm đúp Cài model Recover.command. Model được cài vào ~/Library/Application Support/PixGamma/Models/Recover.
3. Mở lại PixGamma, thẻ Recover sẽ hiện ra.

Yêu cầu máy

	Tối thiểu	Khuyến nghị
macOS	14 Sonoma	15 trở lên
Chip	Apple Silicon M1	M2/M3/M4 Pro, Max hoặc Ultra
RAM	8 GB (các chế độ phóng thường)	32 GB trở lên cho Recover
Ổ trống	1 GB	4 GB nếu cài Recover

Gỡ cài đặt

Xóa /Applications/PixGamma.app và thư mục ~/Library/Application Support/PixGamma. Nếu đã cài CLI, xóa thêm file pixgamma trong /opt/homebrew/bin, /usr/local/bin hoặc ~/.local/bin.

Xử lý sự cố

Hiện tượng	Cách xử lý
macOS báo "bị hỏng"	Chạy lệnh xattr ở trên rồi mở lại
pixgamma: command not found	Bấm đúp Cài lệnh pixgamma (CLI).command, mở Terminal mới
Không thấy thẻ Recover	Chưa cài model Recover
Cập nhật báo token không đọc được repo	Token cần quyền Contents: Read-only cho đúng repo PixGamma
Máy chậm khi chạy Recover	Recover dùng nhiều RAM GPU; đóng máy ảo, trình duyệt nhiều tab