Clarity TagFlow
moving away from java going on to rust so it will be a while for the next update
to get themes working you must reset the app

The intelligent, local-first image tagging solution for dataset curation.

Clarity TagFlow is a modern desktop application designed to streamline the process of tagging images for Machine Learning datasets, stable diffusion training, and digital asset management. Built with a focus on privacy and speed, it runs state-of-the-art AI tagging models entirely on your local machine.

🛠️ System Requirements

• OS: Windows / Linux / macOS

• Runtime: Java 17+

• AI Acceleration: Microsoft Visual C++ Redistributable (for ONNX Runtime on Windows)

🌟 Key Features

🤖 Local AI Powerhouse

• Privacy First: No images are ever uploaded to the cloud. All processing happens 100% offline.

• Multi-Model Support: Seamlessly switch between JoyTag (SOTA) and various WD14 tagging models (ConvNext, SwinV2, Eva02) to get the most accurate results for your specific content.

• Smart Thresholding: Adjust confidence thresholds to control how strict the AI is when applying tags.

⚡ Accelerated Workflow

• Batch Processing: Auto-tag entire folders of images in minutes. Choose to Append new tags to existing ones or Overwrite completely.

• Smart Autocomplete: Type faster with a context-aware autocomplete system that learns from your current dataset and standard tag libraries.

• Sidecar Compatibility: Reads and writes standard .txt sidecar files, ensuring full compatibility with Kohya_ss, OneTrainer, and other training tools.

🎨 Modern Experience

• Sleek Dark UI: A refined, eye-friendly interface designed for long tagging sessions.

• Visual Feedback: Features a "breathing" AI status indicator to let you know exactly when the system is processing.

• Drag & Drop: Easily reorder tags or drag new images into the workflow.

🛡️ Control & Safety

• Global Blacklist: Automatically filter out unwanted tags (e.g., sensitive terms or specific formatting) across all your images.

• Session Memory: Newly added AI tags are highlighted in Cyan, making it easy to review what the AI has changed before saving.

🚀 What's New & Improved

• Smart Booru Downloader: When downloading images from Booru sites, the downloader now automatically fetches the associated tags. This provides an immediate 80-90% accuracy baseline, significantly reducing the need for manual tagging or AI inference on downloaded content.

• Seamless Generation Setup: The generation panel now auto-starts in the background. You no longer need to manually configure the API via .bat files; the app handles the setup automatically.

• In-App Image Generation: Added direct support for generating images within the application workflow.

• Enhanced Tagging Tools: Updated the tagging database to use the latest standards, replacing older, outdated tag sets for better accuracy.

• AI Chat Box: The AI chat interface has been updated for a smoother user experience.

• Tag Manager Expansion: More tags have been added to the tag manager for broader coverage.

🐛 Bug Fixes

• Gallery Navigation: Fixed a frustrating issue where deleting an image would reset the gallery view to page one. The viewer now correctly advances to the next image immediately after deletion.

• Performance Optimization: Fixed all known memory leaks, ensuring the application remains stable and responsive during long tagging sessions.

⚠️ Known Issues

• Video Playback: Users may experience intermittent issues with video playback functionality. This is currently under investigation.

🔮 Roadmap & Future Updates

• Background LLM Tasks: Future updates will allow the LLM to run in the background to automatically convert tags into natural language sentences or captions.

• API Flexibility: We will be adding support for external API logins, allowing you to use cloud models like Gemini or ChatGPT for tagging and captioning if you prefer them over local models.

• Lora & Embedding Overhaul: The current implementation of Loras and Embeddings is being reworked to improve quality and usability.

• Terminus Feature Parity: All missing features from the legacy Terminus Tag Manager will be added to Clarity TagFlow, ensuring a complete upgrade path for existing users.

🔄 A Note to Terminus Users

I am the original creator of Terminus Tag Manager. That project is now abandoned.

Clarity TagFlow is the spiritual successor—rebuilt from the ground up with a new engine, better performance, and local AI features. If you used Terminus, this is your upgrade.

Full Open Source Release: The next major release will be fully open source.