initial commit

2026-07-12 10:17:17 -04:00
commit dab5a4ebc6
1424 changed files with 330463 additions and 0 deletions
@@ -0,0 +1,95 @@
+# 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)