---
title: "Cài đặt & tự cập nhật"
url: https://phatdev.net/docs/pixgamma/cai-dat
lang: vi
updated: 2026-10-22
alternate:
  en: https://phatdev.net/en/docs/pixgamma/cai-dat
markdown: https://phatdev.net/docs/pixgamma/cai-dat.md
---

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

Thuộc bộ tài liệu: [PixGamma](https://phatdev.net/docs/pixgamma.md)

> Cài DMG, lệnh CLI, model Recover, token cập nhật, yêu cầu máy và xử lý sự cố.

## 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:

```bash
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 |