keptinventory/kept

这是什么？

核心功能

• 013D 位置地图，展示楼层、房间、柜架和箱子
• 02带短 ID 和二维码的标签，扫码即可打开对应箱子
• 03AI 辅助录入物品信息，可选择包括本地 Ollama 在内的多种服务商
• 04提供 MCP 服务，便于 Claude 等 AI 代理连接
• 05每晚加密备份到目录、S3 或 SFTP
• 06保修、保养和盘点提醒

适用场景

• 在车库或储物间中管理工具和耗材
• 将物品的保修卡、收据和说明书与物品一并保存
• 借助带编号、可扫码的箱子规划和跟踪搬家
• 与家人或他人共同管理家庭或家庭实验室的共享物品清单

快速上手

1. 1

   下载 compose.yaml 文件

   mkdir kept && cd kept curl -fsSLO https://raw.githubusercontent.com/keptinventory/kept/v1.13.0/compose.yaml
2. 2

   运行 init 设置访问地址并生成 .env

   docker compose run --rm init
3. 3

   启动服务

   docker compose up -d
4. 4

   打开地址，输入设置代码并创建管理员账户

使用前须知

• !采用 AGPL-3.0 许可，若为他人运行修改版，必须提供其源代码。
• !相机、应用安装、推送和位置功能需要 HTTPS，需要额外配置 Caddy。
• !自托管需要 Docker Compose，且至少 2 GB 内存和 2 个 CPU 核心。

收录于专题

标签

常见问题

kept 是什么？

一款可自托管的物品清单应用，记录你拥有的东西、存放位置及相关凭证，内置 3D 地图和 MCP 服务。 Kept 是一款可自托管的开源物品清单工具，适用于住宅、车库和储物间。它记录房间、柜架、箱子以及箱内物品的位置，并可关联收据、说明书、保修卡和历史记录。数据保存在自己的服务器上，默认不发送遥测数据，更新检查默认关闭。

kept 可以免费使用吗？用的什么许可证？

kept 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

kept 还在维护吗？

活跃维护中。kept 最近一次提交是在 2026年11月6日。

kept 适合用来做什么？

在车库或储物间中管理工具和耗材 将物品的保修卡、收据和说明书与物品一并保存 借助带编号、可扫码的箱子规划和跟踪搬家 与家人或他人共同管理家庭或家庭实验室的共享物品清单

kept 怎么安装和运行？

下载 compose.yaml 文件: mkdir kept && cd kept curl -fsSLO https://raw.githubusercontent.com/keptinventory/kept/v1.13.0/compose.yaml 运行 init 设置访问地址并生成 .env: docker compose run --rm init 启动服务: docker compose up -d 打开地址，输入设置代码并创建管理员账户

在哪里获取 kept？

源代码和安装说明在 GitHub 上：https://github.com/keptinventory/kept