Skip to content

Ray25010/Frame-Cull-AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 

Repository files navigation

FrameCull AI logo

FrameCull AI

本地 AI 筛片、图库整理工作台
Local AI photo culling and library cleanup workspace

中文 · English · Download · Flash 教程 · Pro 教程

Release Windows macOS Local AI Flash Pro


中文

FrameCull AI 是一款为拍摄后期选片和大量图库管理而设计的本地 AI 筛片软件。它结合多类视觉识别算法与自训练美学模型,可以在人像、风光、活动拍摄等场景中,帮助你更快挑出值得保留的好片。

除了 AI 精选,FrameCull AI 还支持人物分片、连拍重复选优、合照闭眼检测、RAW 自动曝光、LUT 监看、星级注入等功能,尽量把摄影后期里最繁琐的整理流程变得更轻松。

Flash 版本轻量快速,可在核显机型上流畅运行;Pro 版本则提供更完整的 RAW 监看能力、更丰富的扩展功能,以及更强的自训练 AI 筛选模型。

✨ 两个版本

版本 适合谁 主要特点
FrameCull AI Flash 想要轻量、快速、本地筛片和图库整理的用户 安装包更小,启动快,切图快,支持本地 AI 筛片、人物分片、重复照片清理
🧠 FrameCull AI Pro 需要更强 AI 精选、RAW 曝光预览和专业工作流的用户 自训练蒸馏 AI 引擎、Pro persona 排序、RAW 监看、自动曝光预览、LUT 预览

简单说:Flash 更轻,Pro 更强。
如果你主要看 JPG / RAW 内嵌预览并追求速度,选 Flash;如果你需要 Pro AI 引擎、RAW 自动曝光预览和 LUT 监看,选 Pro。

📦 下载

Windows内测版本:

macOS Flash 0.1.6 测试版

macOS 测试包尚未经过 Apple Developer ID 公证。请根据 Mac 芯片选择正确架构,并根据下方的安装文档进行安装。

📚 文档与教程

💻 系统要求

项目 Flash Windows Flash macOS Pro Windows
系统 Windows 10 / 11 64 位 建议 macOS 12 Monterey 或更高,推荐 macOS 13 及以上 Windows 10 / 11 64 位,推荐 Windows 11
架构 x64 Apple Silicon 使用 arm64 包;Intel Mac 使用 x64 包 x64
CPU 4 核起,推荐 8 核或更高 Apple Silicon,或 4 核及以上 Intel 处理器 8 核起,推荐 12 核或更高
内存 8 GB 起,推荐 16 GB 8 GB 起,推荐 16 GB 16 GB 起,推荐 32 GB 或更高
显卡 无独显要求,集成显卡可运行 无独显要求,使用系统图形与 WebKit NVIDIA GTX 1660 / RTX 2060 / RTX 3050 及以上可用,推荐 RTX 3060 / RTX 4060 及以上;无独显时可 CPU 兜底但会更慢
磁盘 2 GB 可用空间,建议 SSD 2 GB 可用空间,建议 SSD 10 GB 起,推荐 30 GB 以上 SSD 空间用于模型、RAW 监看缓存和导出

🧩 核心能力

🤖 AI 筛片

  • 标记疑似闭眼、失焦、曝光异常、亮部/暗部细节丢失等需要复查的照片。
  • 人像优先关注真实主体,减少背景人物、路人和前景遮挡造成的误报。
  • 风景、空镜、背影、环境人像和活动照片会结合画面结构、曝光和美学线索判断。
  • AI 精选不是简单按分数排序,而是先避开明显硬伤,再给出更值得优先查看的候选。

🧬 Pro 蒸馏 AI 引擎

Pro 版不只是 Flash 加 RAW 监看。它加入了我们自训练和蒸馏的本地 AI 引擎:先用 CLIP / DINOv2 / MUSIQ 等教师模型和人工筛片数据离线训练,再导出更适合本地运行的学生模型,用于辅助低比例 AI 精选排序。

Pro 引擎会输出美学、场景、persona 等多头分数,帮助判断户外活动、环境人像、空镜、背影、合照和复杂场景。它不会绕过硬伤门禁:明显失焦、闭眼硬伤、弃用片和重复组非代表不会因为模型分数高而被强行选入。

👥 人物分片

  • 自动把当前批次中的同一人物聚为一组。
  • 支持人物命名、合并、拆分和手动移动人脸。
  • 同一张多人照片可以同时归入多个人物组。
  • 支持按人物筛选照片并导出结果。

🧹 重复照片清理

  • 自动识别相似照片、连拍和重复组。
  • 每组推荐一张更值得保留的代表图。
  • 支持分组查看、best 标记、同步当前照片和大图复核。

🎞 RAW + JPG 工作流

  • 自动配对同名 RAW + JPG,也保留单独 RAW 或 JPG 文件。
  • 支持保留、弃用、未标记、星级、AI 正常、AI 待复查、AI 精选、重复照片、合照等筛选。
  • 支持 JPEG / TIFF / PNG 导出、原片复制或移动、RAW 同名 XMP sidecar。
  • 支持一键打开 Lightroom Classic 到所选照片文件夹,继续后期流程。

🌈 Pro RAW 监看 / 自动曝光 / LUT

  • RAW 监看用于在筛片阶段提前判断 RAW 色彩、曝光和后期潜力。
  • 自动曝光预览用于快速判断 RAW 的可恢复空间。
  • LUT 监看支持导入 .cube 3D LUT,并以 0-100% 强度预览色彩方向。
  • RAW 监看和自动曝光默认关闭,用户手动生成缓存后再启用,不阻断 JPG 筛片流程。

🚧 当前状态

FrameCull AI 仍处于内测阶段。Windows 安装包和 macOS Flash 双架构测试包已可下载;macOS 测试包尚未公证,首次打开请按上方教程操作。欢迎反馈真实筛片需求、测试样片和工作流建议。

📮 联系作者

  • 邮箱:2923834023@qq.com

English

FrameCull AI is a desktop photo-culling workspace for photographers. It brings fast review, AI review signals, AI Picks, duplicate cleanup, people grouping, ratings, Lightroom Classic handoff, and export management into one focused app.

FrameCull AI runs locally. It does not upload your photos, and it does not silently delete anything for you. The AI helps organize signals, rank candidates, and reduce repetitive work; the final keep, reject, rating, and export decisions remain yours.

✨ Editions

Edition Best for Highlights
FrameCull AI Flash Users who want a lightweight and fast local culling tool Smaller installer, quick startup, fast navigation, local AI culling, people grouping, duplicate cleanup
🧠 FrameCull AI Pro Users who need stronger AI Picks, RAW exposure preview, and a more advanced workflow Self-trained distilled AI engine, Pro persona ranking, RAW monitor preview, auto-exposure preview, LUT preview

In short: Flash is lighter. Pro is stronger.
Choose Flash if you mainly review JPGs or embedded RAW previews and care most about speed. Choose Pro if you want the Pro AI engine, RAW auto-exposure preview, and LUT monitoring.

📦 Download

Windows release:

macOS Flash 0.1.6 test build

The macOS test packages are not notarized with Apple Developer ID. Download them only from this repository's official Release page and choose the package that matches your Mac architecture.

📚 Docs

💻 Requirements

Item Flash Windows Flash macOS Pro Windows
OS Windows 10 / 11 64-bit macOS 12 Monterey or later recommended for testing; macOS 13 or later preferred Windows 10 / 11 64-bit, Windows 11 recommended
Architecture x64 Use the arm64 package on Apple Silicon and the x64 package on Intel Macs x64
CPU 4 cores minimum, 8+ cores recommended Apple Silicon, or a 4-core or better Intel processor 8 cores minimum, 12+ cores recommended
Memory 8 GB minimum, 16 GB recommended 8 GB minimum, 16 GB recommended 16 GB minimum, 32 GB or more recommended
GPU No discrete GPU required No discrete GPU required; uses system graphics and WebKit NVIDIA GTX 1660 / RTX 2060 / RTX 3050 or above; RTX 3060 / RTX 4060 or above recommended. CPU fallback is available but slower
Disk 2 GB free space, SSD recommended 2 GB free space, SSD recommended 10 GB minimum, 30 GB or more SSD space recommended for models, RAW preview cache, and exports

🧩 Core Features

🤖 AI Culling

  • Flags photos that may need review, such as closed eyes, missed focus, exposure issues, and lost highlight or shadow detail.
  • Prioritizes the real subject in portraits to reduce false alarms from background people or foreground occlusion.
  • Handles landscapes, empty scenes, back views, environmental portraits, and event photos with scene, exposure, and aesthetic signals.
  • AI Picks avoid obvious hard faults first, then surface stronger candidates for review.

🧬 Pro Distilled AI Engine

Pro is not just Flash with RAW preview. It adds a self-trained distilled local AI engine. Teacher models such as CLIP / DINOv2 / MUSIQ and human culling data are used offline to train smaller student models that better match real photo-culling preferences.

The Pro engine produces aesthetic, scene, and persona scores for AI Pick ranking, especially at stricter pick ratios. It does not override hard gates: obviously out-of-focus images, closed-eye hard faults, rejected photos, and duplicate non-representatives are still blocked by the rule layer.

👥 People Grouping

  • Groups the same person across the current batch.
  • Supports naming, merging, splitting, and manually moving faces.
  • Allows one group photo to belong to multiple people groups.
  • Supports filtering and exporting by person.

🧹 Duplicate Cleanup

  • Detects similar images, burst sequences, and duplicate groups.
  • Recommends a better representative for each group.
  • Provides a duplicate review workspace for grouped review, best marking, current-photo sync, and large preview checks.

🎞 RAW + JPG Workflow

  • Pairs matching RAW + JPG files while keeping standalone RAW or JPG files.
  • Supports keep, reject, unmarked, star rating, AI normal, AI review, AI Pick, duplicate, and group-photo filters.
  • Supports JPEG / TIFF / PNG export, original file copy or move, and RAW sidecar XMP.
  • Opens Lightroom Classic to the selected photo folder for downstream editing.

🌈 Pro RAW Monitor / Auto Exposure / LUT

  • RAW monitor preview helps judge RAW color, exposure, and post-processing potential during culling.
  • Auto-exposure preview helps estimate recoverable RAW range quickly.
  • LUT monitor supports .cube 3D LUT files with 0-100% preview strength.
  • RAW monitor and auto exposure are off by default; users generate caches manually, so JPG culling stays available.

🚧 Status

FrameCull AI is currently in beta. Windows installers and dual-architecture macOS Flash test packages are available. The macOS packages are not notarized, so follow the installation steps above for first launch.

Feedback on real culling needs, test samples, and workflow improvements is welcome.

📮 Contact

  • Email: 2923834023@qq.com

Packages

 
 
 

Contributors