macOS
Homebrew已验证 · 100%
brew install immich-clilocal Homebrew formula metadata
安装
其他安装命令
Linux
Nix已验证 · 92%
nix profile install nixpkgs#immich-clinixpkgs package indexes · pkgs/by-name/im/immich-cli/package.nix · 来源: api.github.com
概览
软件包摘要
Command-line interface for self-hosted photo manager Immich
历史
项目历史与用法
immich-cli is the official command-line interface for Immich, the self-hosted photo and video management project. It is distributed from the Immich monorepo as the @immich/cli npm package and as an immich-cli container image.
项目历史
Immich's GitHub repository was created on 2022-02-03 and grew into a high-profile self-hosted alternative to cloud photo libraries. The CLI became the official automation surface for uploading photos and videos, checking server information, and authenticating with API keys outside the web and mobile clients.
The @immich/cli package metadata records publication history beginning in 2023. Official documentation describes the migration from a legacy npm package named immich to the scoped @immich/cli package, plus a Docker invocation path for users who do not want to install Node.js locally.
采用历史
immich-cli adoption follows Immich adoption. Repository metadata shows Immich with a very large GitHub audience, and Homebrew formula analytics show the CLI receiving thousands of installs over the measured 365-day formula window. The input metadata also records Nix packaging.
The CLI occupies a pragmatic role in the Immich ecosystem: it is the supported tool for bulk upload and scripting, while the official docs point users with Google Photos Takeout needs to the community-maintained immich-go tool.
使用方式
The official docs document login with an Immich server URL and API key, storage of credentials in auth.yml under ~/.config/immich by default, upload of files and directories, recursive upload, dry runs, album creation, duplicate handling, ignore globs, concurrency, JSON output, and environment-variable configuration.
为什么软件包爱好者会关心
immich-cli is package-nerd significant because it is a companion CLI for a fast-moving self-hosted application, and its packaging spans npm, Docker, Homebrew, and Nix. It also demonstrates the common tradeoff that led to immich-go: official Node-based CLIs are easy for project maintainers to ship from a TypeScript monorepo, while some users prefer static single-binary migration tools.
时间线
- 2022-02-03: Immich GitHub repository created.
- 2023-11-19: @immich/cli npm package metadata records its package creation date.
- 2025-10-01: Immich v2.0.0 stable release published.
- 2026: Official CLI docs describe @immich/cli installation, Docker usage, auth.yml credentials, and upload commands.
Related projects
- immich-cli is part of the Immich monorepo and depends on the Immich server API. The official CLI docs recommend immich-go for Google Photos Takeout import workflows, making the two tools related but not equivalent.
来源
安全态势
风险级别：绿色
narrow executable package without higher-risk signals.
风险分类器
绿色 风险 · 低 置信度 · appliance
原因
- narrow executable package without higher-risk signals
信号
- metadata:no-higher-risk-signals
安装行为
- formula 元数据中未记录 Homebrew post-install 钩子。
- Homebrew bottle 元数据适用于 1 个平台目标。
- 安装时包含 1 个运行时依赖。
建议审查
在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
~/.config/immich/auth.yml
Credential files
Credential-bearing paths to review before unattended agent runs.
- Unix
~/.config/immich/auth.yml
可执行文件
已安装的可执行文件
| 命令 | 类型 | 暴露范围 | 备注 |
|---|---|---|---|
immich | cli | 全局可执行文件 |
新鲜度
版本和新鲜度
这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。
页面生成时间2026-07-08
管理器版本3.0.1
管理器更新时间2026-07-04
本地数据OK
上游not checked
检测到的最新版本未检测到
https://immich.app/docs/features/command-line-interface
- 信息Release/tag comparison is only available for GitHub repositories.https://immich.app/docs/features/command-line-interfacenone 置信度
安装元数据
软件包元数据
| 软件包键 | brew:immich-cli |
|---|---|
| 版本 | 3.0.1 |
| 软件包管理器 | Homebrew |
| 软件包管理器页面 | https://formulae.brew.sh/formula/immich-cli |
| 主页 | https://immich.app/docs/features/command-line-interface |
| 仓库 | https://github.com/immich-app/immich |
| 上游文档 | https://docs.immich.app/features/command-line-interface |
| 许可证 | AGPL-3.0-only |
| 源码归档 | https://registry.npmjs.org/@immich/cli/-/cli-3.0.1.tgz |
| 最后更新 | 2026-07-04T02:30:15Z |
| Pulse | updated |
| 依赖 | node |
| Bottle | 可用 (于 all) |
| Homebrew post-install | 未定义 |
| 服务 | 未声明 |
注册表事实
源数据库详情
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | immich-cli |
| Version Scheme | 0 |
| Revision | 0 |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
源数据库匹配
其他软件包管理器记录
匹配项来自外部软件包管理器索引，并与本地 Automic Vault 软件包链接分开显示。
Nix95%
immich-cli
nix profile install nixpkgs#immich-cli- normalized package name match
- 匹配方式：Immich Cli
Nix92%
immich
nix profile install nixpkgs#immich- installed executable or alias match
- 匹配方式：Immich
来源线索
由仓库数据生成
此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。
Combined YAML source
View the package source record on GitHub.
使用的来源
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment