hermes-config/skills/software-development/immich-server/references/import-progress-reference.md

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

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