Immich-Go is a command-line tool for uploading photo collections to a self-hosted Immich server without requiring NodeJS installation.
The tool addresses the challenge of migrating large photo libraries to Immich by providing a standalone binary that handles multiple source formats including Google Photos Takeout archives, iCloud exports, local folders, ZIP files, and transfers from other Immich servers. It works by processing files from these sources, detecting duplicates, stacking burst photos, and intelligently handling RAW and JPEG pairs before uploading to the target server.
Developers managing large photo collections should consider this tool if they want to avoid NodeJS dependencies and need to handle diverse import sources. It suits projects involving Google Photos migration, cross-platform deployment, or managing collections exceeding tens of thousands of photos. The tool includes sensible defaults for filtering system files and artifacts, with customizable ban patterns for excluding unwanted content. It maintains compatibility with both Immich V2 and V3, though the README notes this is an early version and recommends keeping backup copies of files during migration.
The project shows active development with recent updates addressing API changes, including removal of deprecated asset replacement methods. Documentation is comprehensive, covering installation across Windows, macOS, Linux, and FreeBSD, with detailed guides for configuration, commands, and best practices. The tool successfully handles large-scale uploads and provides cross-platform binary releases for straightforward installation.
