FileID
Drag to spin
On-device AI file organization

FileID

Tag, dedupe, restructure, and rename
tens of thousands of files — privately,
on hardware you own.

Download View source
The six tabs

Every workflow in one window.

Library

FTS5 search over filenames + OCR. Semantic CLIP search — type "a dog at the beach" and get the photo. RAM++ auto-tagging, thumbnail grid + preview sheet.

RAM++ · CLIP · FTS5 · OCR

People

Face clusters from on-device SFace embeddings. Drag to merge. Name a cluster once — every AI caption uses real names from then on.

YuNet · SFace

Cleanup

Duplicate groups by perceptual hash. Trashed files stay recoverable until you say otherwise. No surprises.

dHash · pHash

Deep Analyze

On-device vision-language model writes a caption and proposes a smart filename — for images, PDFs, video keyframes, doc thumbnails.

Qwen 2.5-VL 7B · Gemma 3 · Mistral-Small-3.2

Restructure

Folder reorganization with a Sankey flow diagram. Apply as shortcuts (reversible), then convert to real moves when you're happy.

Reversible · Sankey

Settings

Model downloads, GPU acceleration picker, engine info, logs, privacy controls. Hardware diagnostics for the curious.

DirectML · CoreML · AVX2/NEON floor
Five front-ends

One engine. Pick your window.

Three native desktop apps and two terminal clients — all reading and writing the same library. No web tech anywhere: every GUI is native to its OS.

macOS app

The canonical visual and behavioral reference, tuned for Apple Silicon. Writes real Finder tags, so they show up in Spotlight and Smart Folders.

SwiftUI · MLX · CoreML

Windows app

Mica backdrop, springs-everywhere motion, and the same six tabs. Windows 10/11 on x64 and Snapdragon WoA.

WinUI 3 · .NET 8 · DirectML

Linux app

GNOME-native port over the shared Rust engine — the same six tabs, the same gold palette, the same motion language.

GTK4 · libadwaita

fileid CLI

Scan, search, dedupe, and plan restructures headlessly — ideal for servers and NAS boxes. Read-only by default; every destructive action is behind an explicit flag.

Rust · scriptable · --json

fileid-tui

A terminal dashboard over the same library. Browse, search, and kick off a full-ML scan without leaving the shell.

Rust · ratatui

One library

A library scanned on one platform opens on another — database migrations are byte-faithful across the Swift and Rust engines.

SQLite WAL · portable
Privacy posture

100% on-device.
Zero telemetry.

FileID ships no analytics SDKs, no crash reporters, no "anonymous usage" pings. Your files never leave the machine. User-requested model and optional hardware-runtime downloads are restricted to the reviewed upstream host baseline; CI rejects unreviewed additions.

  • Local SQLite WAL database in your app-support directory.
  • Model weights download directly from Hugging Face — FileID never redistributes weights.
  • Outbound allowlist: CI rejects any addition beyond the documented, reviewed upstream baseline.
  • Privacy gate scans every shipped binary against a 23-string deny-list before release.
CI privacy gate
0
telemetry strings allowed in any release binary
23
deny-listed SDK substrings (Sentry, Datadog, Firebase, …)
6
reviewed upstream runtime host families
$ privacy_scan --binary FileIDEngine.exe
✓ 0 telemetry strings
✓ 0 unreviewed runtime hosts
✓ reviewed runtime host baseline
✓ release egress gate passed
→ no unreviewed network destinations
Releases

v0.1.0 is live.

Clearly labeled unsigned v0.1.0 binaries and installers are published on the releases page. They are not public-trust signed. Building from source is also supported.

macOS

15+ · Apple Silicon

Drag to Applications. SwiftUI app + Swift engine on MLX / CoreML / Neural Engine. The canonical reference port — every tab ships end-to-end.

macOS releases page unsigned v0.1.0 dmg

Or build from source — one command, every platform:

./build.sh -windows         # Windows: full fresh-install build + run
./build.sh -mac             # macOS:   build + launch
./build.sh -linux           # Linux:   GTK4 app + engine
How it's built

Two binaries. One IPC contract.
Crash isolation by design.

Same architecture as VS Code's renderer / extension-host split. A panic in ML doesn't kill the UI — the engine respawns with bounded backoff.

APP
FileID.exe / FileID.app
  • SwiftUI (macOS) · WinUI 3 (Windows) · GTK4 (Linux)
  • Verifies engine signature before spawn
  • Auto-respawns on crash (1s · 4s · 16s)
stdin / stdout newline-delimited JSON
ENGINE
FileIDEngine
  • Rust (Windows · Linux) · Swift (macOS)
  • SQLite WAL · single writer
  • Scan pipeline · ML inference