Immich – Self-Hosted Google Photos Alternative

SkillMedia

Self-hosted photo and video management with Immich

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Immich skill

What this skill tells your AI

The instructions your AI receives, as published by bidewio/better-openclaw in skills/immich-photos/SKILL.md and read by ahel’s review.

Immich provides high-performance photo and video backup with AI-powered facial recognition, object detection, and smart search.

  • GitHub: github.com/immich-app/immich (65 000+ ⭐)
  • License: AGPL-3.0
  • Security: Active security-focused development team. No malware.

Environment Variables

VariableDescription
{{IMMICH_URL}}Base URL of the Immich instance
{{IMMICH_API_KEY}}API key for authentication

Usage Examples

Get server info

curl -s "{{IMMICH_URL}}/api/server/info" \
  -H "x-api-key: {{IMMICH_API_KEY}}"

Search assets

curl -s -X POST "{{IMMICH_URL}}/api/search/metadata" \
  -H "x-api-key: {{IMMICH_API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{"originalFileName": "vacation"}'

Upload an asset

curl -s -X POST "{{IMMICH_URL}}/api/assets" \
  -H "x-api-key: {{IMMICH_API_KEY}}" \
  -F "assetData=@photo.jpg" \
  -F "deviceAssetId=unique-id" \
  -F "deviceId=api" \
  -F "fileCreatedAt=2025-01-01T00:00:00.000Z" \
  -F "fileModifiedAt=2025-01-01T00:00:00.000Z"

AI Agent Tips

  • Smart search uses CLIP embeddings for natural-language photo queries.
  • Mobile apps auto-backup photos; API enables programmatic uploads.
  • Supports RAW file formats and video transcoding.
  • Face recognition groups photos by person automatically.

Signals

GitHub stars
58
Forks
6
Last commit
Aug 2026
Advanced
Item type
skill
Key
immich-photos
Source
github.com/bidewio/better-openclaw