# Import Progress Reference

> Companion for the `immich-server` skill. Documents what to expect during and after a large immich-go import.

## immich-go Progress Output

When running immich-go `from-google-photos`, output scrolls like:

```
Immich read 100%, Assets found: 18595, Upload errors: 0, Uploaded 2735
Immich read 100%, Assets found: 18595, Upload errors: 0, Uploaded 2742
...
```

Key fields:
- **Assets found** — total photos/videos detected (excludes .json sidecars)
- **Uploaded** — running count of files sent to Immich
- **Upload errors** — should stay 0; if non-zero, check the server logs

### Final Summary Format

```
Asset Tracking Report:
=====================
Total Assets:      18595  (183.1 GB)
  Processed:       16590  (149.9 GB)
  Discarded:        1987  (33.2 GB)
  Errors:              0  (0 B)
  Pending:            18  (35.2 MB)

Event Report:
=============
Discovery (Assets):
  discovered image                   :   17805  (44.8 GB)
  discovered video                   :     790  (138.3 GB)

Discovery (Non-Assets):
  discovered sidecar                 :   18377  (13.8 MB)
  discovered unknown file            :    1046  (-)
  discovered unsupported file        :     244  (208.9 MB)

Asset Lifecycle (PROCESSED):
  uploaded successfully              :   16401  (148.7 GB)
  server asset upgraded              :     101  (907.2 MB)
  metadata updated                   :   16502  (355.2 MB)

Asset Lifecycle (DISCARDED):
  discarded local duplicate          :    2062  (33.5 GB)

Processing Events:
  associated metadata                :   18577
  missing metadata                   :      18
  stacked                            :     459
  added to album                     :     933
  tagged                             :   29069
```

**What the sections mean:**
- **Processed** vs **Discarded** — processed = newly uploaded, discarded = already existed on server (deduplicated by content hash)
- **Pending** (18) — 18 assets that didn't reach a final state. Usually harmless edge case; those files likely uploaded but the status check didn't confirm before the tool exited. Manually verify by checking Immich's asset count after processing finishes.
- **added to album** (933) — Google Photos albums recreated in Immich
- **tagged** (29069) — people tags from Google Photos applied
- **stacked** (459) — burst photos grouped into stacks

## Monitoring During Import

For background processes (via Hermes terminal background=true):

```python
# Check progress with poll()
process(action="poll", session_id="proc_xxx")

# When the imported finishes, capture the full output:
process(action="log", session_id="proc_xxx")
```

## Sample Job Queue After Large Import

After importing ~18,595 assets (16,401 new), expect queues like:

```
🟢 thumbnailGeneration: 3 active, 890 waiting
🟢 metadataExtraction: 5 active, 10587 waiting
🟢 videoConversion: 1 active, 260 waiting
🟢 smartSearch: 2 active, 2574 waiting
🟢 faceDetection: 2 active, 6698 waiting
🟢 facialRecognition: 1 active, 4358 waiting
🟢 ocr: 1 active, 8421 waiting
🟢 storageTemplateMigration: 1 active, 825 waiting
```

Processing all jobs on a 4-core i5-6500T with 7GB RAM takes approximately:
- Thumbnails + metadata: 2-4 hours
- Smart search (CLIP), face rec, OCR: 12-24 hours each
- Video conversion: 10-20 hours (if enabled)
