RepoPilot

immich-app/immich

High performance self-hosted photo and video management solution.

Healthy

Strong maintenance signals

ConcernsDependency

copyleft license (AGPL-3.0) — review compatibility

HealthyFork & modify

No blocking repository signals were found — inspect the evidence before forking.

HealthyLearn from

Documented and popular — useful reference codebase to read through.

HealthyDeploy as-is

No blocking repository-level signals were found; deployment review is still required.

  • ⚠AGPL-3.0 is copyleft — check downstream compatibility
  • ✓Last commit today
  • ✓33+ active contributors
  • ✓Distributed ownership (top contributor 20% of recent commits)
  • ✓AGPL-3.0 licensed
  • ✓CI configured
  • ✓Tests present

What would improve this?

  • •Use as dependency Concerns to Mixed if: relicense under MIT/Apache-2.0 (rare for established libs)

Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

Informational only. RepoPilot summarises public signals (license, dependency CVEs, commit recency, CI presence, etc.) at the time of analysis. Signals can be incomplete or stale. Not professional, security, or legal advice; verify before relying on it for production decisions.

Repository brief

Repo brief: immich-app/immich

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T12:44:23.214Z · commit 1fd3d8749218

Verdict

Healthy — Strong maintenance signals

  • Last commit today
  • 33+ active contributors
  • Distributed ownership (top contributor 20% of recent commits)
  • AGPL-3.0 licensed
  • 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

Immich is a self-hosted photo and video management solution written primarily in TypeScript and Dart, offering high-performance asset organization and retrieval without relying on cloud services. It provides a web interface (Svelte) and mobile apps (Dart/Flutter for Android, Swift for iOS) to upload, organize, and view media libraries with features like video transcoding, hardware acceleration, and multi-user support. Monorepo with npm workspaces: packages/cli contains the TypeScript CLI tool, packages/sdk wraps client-facing API logic, packages/plugin-sdk provides extensibility interfaces, and packages/plugin-core implements core functionality. Separate native codebases exist for Android…

Start here

Open these first:

  • packages/sdk/src/index.ts — Main SDK entry point exposing client API for photo/video management operations.
  • packages/cli/src/index.ts — CLI tool entry point for server interaction and asset management commands.
  • packages/plugin-sdk/src/sdk.ts — Plugin system SDK enabling extensibility and third-party integrations.
  • docker/docker-compose.prod.yml — Production deployment manifest defining service architecture and container orchestration.
  • CONTRIBUTING.md — Contribution guidelines and development workflow expectations.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone: git clone https://github.com/immich-app/immich.git && cd immich. Install dependencies: npm install (for TypeScript packages). For Android: verify Android SDK 26+ and Gradle; for iOS: verify Xcode and Swift. For D…

Daily commands:

Docker (production): docker-compose -f docker/docker-compose.prod.yml up. Docker (rootless): docker-compose -f docker/docker-compose.rootless.yml up. Development: docker-compose -f docker/docker-compose.dev.yml up. Web…

…shortened for this brief.

Key cautions & unknowns

  • AGPL-3.0 is copyleft — check downstream compatibility
  • Android signing requires key.jks and key.properties files (build.gradle.kts references System.getenv for ALIAS, ANDROID_KEY_PASSWORD, ANDROID_STORE_PASSWORD—these must be set for release builds). Docker Compose files…
  • Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

For the complete agent context, use the CLAUDE.md or Cursor rules export.

Save as

Full context for agent files, or a concise PDF for human review.

View complete agent reference

Open to load every section of the agent reference.

Want this for your own repo?

Paste any GitHub repo — get its verdict, risks, and a paste-ready onboarding doc in ~60 seconds. Free, no sign-up.

Embed the "Healthy" badge

Paste into your README — live-updates from the latest cached analysis.

Variant:
RepoPilot: Healthy
[![RepoPilot: Healthy](https://repopilot.app/api/badge/immich-app/immich)](https://repopilot.app/r/immich-app/immich)

Paste at the top of your README.md — renders inline like a shields.io badge.

▸Preview social card

This card auto-renders when someone shares https://repopilot.app/r/immich-app/immich on X, Slack, or LinkedIn.

Ask AI about immich-app/immich

Grounded in the actual source code. Pick a starter question or write your own.

What does this repo do, in one paragraph?How would I get started using it?What are the main alternatives?Show me the entry point.
Or write your own question

Featured in lists

Curated shortlists that include this repo.

Embed this chat in your README

Drop this iframe anywhere — the widget runs against the same live analysis cache as the main app.

<iframe
  src="https://repopilot.app/embed/immich-app/immich"
  width="100%" height="500"
  style="border:1px solid #d0d7de; border-radius:8px;"
  allow="microphone"
  loading="lazy"
></iframe>