A high-performance, ultra-low-memory desktop utility designed to wrangle massive AI model libraries. It organizes Checkpoints, LoRAs, and embeddings by architecture (SDXL, Pony, Flux, SD 1.5, etc.) using zero-copy .safetensors header parsing and an automated Civitai metadata fetcher—all wrapped in a premium glassmorphism interface built on the shared Latent Design System.
Sleek, frameless desktop UI with tabbed navigation for Sorting and Fetching.
Sorter: Organizes models by architecture, with a post-run summary of every move.
💡 Tip: Run Fetcher before Sorter for best results. Without a local
.civitai.infosidecar, the Sorter falls back to the model's internal.safetensorsheader or filename heuristics — which is accurate for most architectures, but can't always distinguish closely-related fine-tunes (e.g. Illustrious vs. NoobAI vs. Pony) the way Civitai's own metadata can.
Fetcher: Fetches metadata and preview images from Civitai.
View More Features (Fetcher Run Summary)
Fetcher Summary: Tallies metadata retrieved, previews downloaded, and trigger words saved.
Engineered from the ground up for power users managing terabytes of models, prioritizing safety and speed.
- Standalone Desktop App: Runs as a single
.exe(Windows),.AppImage(Linux), or.dmg(macOS). No installer required. - Bundled Runtime: Includes a self-contained Java 21 environment. No system-wide Java installation is required.
- Secure Local Execution: The UI communicates with the Java engine over a secure, token-authenticated IPv4 loopback (
127.0.0.1). It never binds to external network interfaces, completely bypassing annoying OS firewall prompts and guaranteeing your local file operations cannot be intercepted. - Dry Run Mode: Test your organization parameters safely. The app will calculate hashes, read headers, and output exactly what would happen to the console without moving a single file.
- Deep Scanning: Toggle recursive scanning to organize models buried deep within nested subfolders.
- Non-Destructive Grouping: Associated files (e.g.,
model_v1.safetensors,model_v1.preview.png,model_v1.civitai.info) are safely bundled and moved as atomic units. - Smart Collision Handling: If a model with the same name already exists in the target folder, the app safely renames the incoming model and all of its associated sidecars (e.g.,
model (1).safetensors) to guarantee zero data loss. - Transactional Restores: An automated
undo-manifest.jsontracks every move, allowing you to instantly revert thousands of files back to their exact original locations.
- Zero-Memory Safetensors Parsing: Reads massive 6GB+
.safetensorsfiles without loading them into RAM. It memory-maps only the first 8 bytes to locate the exact length of the JSON header, bypassing heap memory bloat entirely. - Advanced Architecture Detection: Automatically identifies base models (Flux, SDXL, Pony, Illustrious, SD 1.5, SD 3.5, Sana, Noob V, etc.) based on internal metadata tags or intelligent filename heuristics.
- Civitai Metadata Fetcher (3-Tier Fallback):
- Checks for local
.civitai.infosidecar files (Instant). - Reads the internal
.safetensorsmetadata JSON header (Fast). - If unknown, calculates a highly optimized SHA256 hash, queries the Civitai API asynchronously, saves the JSON locally, and streams the preview thumbnail directly to disk (Zero-Memory).
- Checks for local
- Smart File Grouping: Employs a descending-length prefix-matching algorithm to ensure that orphaned preview images or text files are never left behind when their parent model is moved.
- Blistering Performance: * Powered by Java 21 Virtual Threads (Project Loom).
- Launches a lightweight virtual thread for every single model group, allowing your OS to parallelize massive I/O operations instantly. Organize thousands of models in seconds.
- Modern UX & Customization:
- Premium "Glassmorphism" UI with draggable frameless window controls.
- Real-time console terminal overlay for developer-level transparency.
- Post-run Summary Modals detailing exactly how many files were moved to each architecture folder.
- OS: Windows 10/11 (64-bit), Linux (AppImage), or macOS (11+).
- Memory: Extremely efficient. Requires < 100MB of RAM during peak operation. Minimum 2GB RAM overall.
- Storage: ~150MB for the application.
- Network: An active internet connection is only required when using the "Fetcher" mode to download metadata/images from Civitai. "Sorter" mode is 100% offline.
Latent Model Organizer bypasses heavy frameworks to deliver raw native performance, combining an ultra-lightweight backend with a modern frontend.
-
Backend (Java 21):
- Raw HttpServer: Uses
com.sun.net.httpserverwith zero heavy dependencies (No Spring Boot, no external HTTP libraries). - Project Loom:
VirtualThreadPerTaskExecutorhandles extreme concurrency for file hashing and I/O. - NIO FileChannels: Byte-level manipulation of large files using
java.nio. - SSE Telemetry: Custom Logback Appender pipes SLF4J logs directly to the frontend via Server-Sent Events.
- Raw HttpServer: Uses
-
Frontend (Vue 3 + Vite):
- Composition API: Highly reactive state management for UI toggles and API payloads.
- Latent Design System: Shared token layer (colors, spacing, typography) and
ds/component primitives (StatusPill,LBadge,LSwitch) kept in sync with the sister Latent apps. - Glassmorphism CSS: Centralized, premium design system utilizing
backdrop-filter.
-
Desktop (Electron):
- ContextBridge IPC: Secure communication between the Vue renderer and native OS APIs (Folder selection, Window management).
- Process Orchestration: Gracefully spins up and tears down the Java backend as a background child process.
- Download the appropriate file for your OS:
- Windows:
Latent Model Organizer X.X.X.exe - Linux:
Latent Model Organizer-X.X.X.AppImage(mark as executable withchmod +x) - macOS:
Latent Model Organizer-X.X.X.dmg
- Windows:
- Run the application. No installation is required.
- Select Folders: Pick your source directory and your target directory.
- (Optional) Toggle "Dry Run" on your first attempt to verify where models will be routed.
- Click Start and watch the virtual threads work their magic.
🍎 macOS Users: Because this app is not yet signed with an Apple Developer Certificate, you may see an error saying the app is "damaged and can't be opened." This is a standard macOS security message for unsigned apps.
To fix this:
- Move the app to your Applications folder.
- Open Terminal.
- Run the following command to clear the quarantine attribute:
sudo xattr -cr "/Applications/Latent Model Organizer.app"- You can now open the app normally.
Latent Model Organizer automatically remembers your selected directories, chosen architectures, and toggle states (Deep Scan / Dry Run) via localStorage. You can safely close the app and pick up right where you left off.
Distributed under the MIT License with the Commons Clause. Free to use, modify, and share. The Commons Clause restricts selling the Software or offering it as a paid hosted/consulting service. See LICENSE for the full text.
If Latent Model Organizer has saved you hours of manual sorting, consider supporting its ongoing development.
