Skip to content

Releases: albertdobmeyer/agentic-file-sorter

AFS v1.3.0

22 Mar 21:02
@albertdobmeyer albertdobmeyer
v1.3.0
ba68516

Choose a tag to compare

View all tags
AFS v1.3.0 Latest
Latest

What's New

Three-Step Pipeline

  • Step 1 — Vision model names files (per-file, CDR security for memes)
  • Step 2a — Reasoning model consolidates redundant folders (one call, holistic)
  • Step 2b — Reasoning model assigns files to topic folders (chunked)

Photo Detection & CDR Skip

Camera photos auto-detected via EXIF metadata, resolution (>4MP), and filename patterns (IMG_, DSC_, PXL_, etc.). CDR re-rendering skipped to preserve original quality and EXIF data.

Face Recognition

Place face samples in faces/ directory (supports multiple samples per person via subdirectories). The vision model identifies named people in photos using Ollama's multi-image API. Zero additional dependencies.

Folder Consolidation

Step 2a evaluates all folder names holistically and merges redundant ones (pol → politics, sci → science). Junk folders named after file extensions are flagged for re-sorting.

Quality of Life

  • python afs.py flatten <dir> — move files from subfolders back to root
  • --reface flag — re-run face identification only (skip expensive vision analysis)
  • --force — reprocess all files ignoring prior manifest
  • Sleep prevention — Windows won't sleep during long runs
  • Full afs-config.json ships with all settings and defaults visible
  • setup.sh — one-command install that checks all prerequisites

Naming Quality

  • Synonym deduplication (dark/void/night → dark)
  • Meta-word filtering (image/photo/camera/person banned from filenames)
  • Photo-specific prompts (WHO/WHAT/WHERE priority)
  • Camera sequence numbers preserved at end of filename

Quick Start

git clone https://github.com/albertdobmeyer/agentic-file-sorter.git
cd agentic-file-sorter
bash setup.sh
python afs.py process ~/Downloads

Using Claude Code? Point it at this repo — it reads CLAUDE.md automatically.

Assets 2
Loading