# LoRA Tagging Assistant
LoRA Tagging Assistant is a Windows application designed to make preparing image datasets for LoRA training easier and more efficient.
It provides tools for editing tags and captions, running AI-assisted tagging and caption generation, organizing dataset files, cropping images, and performing batch operations from a single interface.
The application is completely free to use.
---
## Main Features
### Tag Editing
- Edit tags for individual images.
- Add, remove, replace, and reorder tags.
- Batch add / remove tags across a folder.
- Prepend or append tags.
- Search and extract images based on tags.
- Tag Pool for reviewing tags used throughout the current folder.
- Forbidden / NG tag detection.
### AI Auto Tagging
- Local AI tagging using ONNX models such as WD14-compatible taggers.
- Adjustable confidence threshold.
- Single-image and batch tagging.
- Batch processing with progress display and cancellation support.
### AI Caption Generation
Caption generation is available using:
- Gemini
- OpenAI
- Florence-2
Features include:
- Single-image caption generation
- Batch caption generation
- Configurable caption detail
- Configurable caption file extension
- Automatic caption saving
- Caption text copy button
- Progress, processing time, and error reporting
API quota and content-related errors are handled so that unnecessary requests are avoided and detailed information can be recorded in logs.
---
## Dataset File Management
LoRA Tagging Assistant treats image files and their related metadata files as a set.
Supported related files include:
- .txt tag files
- .caption caption files
When copying, moving, renaming, or deleting an image, the corresponding tag and caption files can be processed together.
When files with the same name already exist in the destination, you can choose:
- Replace All Files
- Add Missing Files Only
- Skip This Entire Image Set
- Cancel
The same choice can optionally be applied to subsequent conflicts during the same operation.
---
## Image Cropping
The built-in crop tool supports:
- Adjustable crop selection
- 8-direction resize handles
- Moving the crop area
- Safe file replacement
- One-level Undo Crop
---
## ZIP Export
Datasets can be exported to ZIP while including the corresponding image, tag, and caption files.
After export, the destination folder can be opened directly from the application.
---
## UI
- Japanese / English interface
- Light / Dark themes
- Adjustable panel layout
- Thumbnail browser
- Image preview
- Image metadata display
- Favorite folders
- In-app help
- Diagnostic log access
---
## Help
Japanese and English help files are included with the application.
You can open them directly from:
Help → Usage Guide
Diagnostic logs can also be opened from the Help menu.
---
## Supporting Development
LoRA Tagging Assistant is available with all features free of charge.
If you find the application useful and would like to support future development, testing, maintenance, and feature improvements, you can optionally support the project on Ko-fi.
Ko-fi:
Support is completely optional, and there is no difference in available features whether or not you choose to support the project.
---
## Requirements / Distribution
LoRA Tagging Assistant is distributed as a Windows application.
The release package includes the files required to run the application, so a separate Python installation is not required.
For AI tagging, the included model files are stored with the application resources.
Gemini and OpenAI caption generation require your own API key.
Florence-2 runs locally.
---
## Notes
Before using batch operations on an important dataset, keeping a backup is recommended.
LoRA Tagging Assistant is actively being improved, with future updates planned around tag organization, advanced filtering, and dataset inspection tools.
---for japanese---
# LoRA Tagging Assistant
LoRA Tagging Assistant は、LoRA学習用画像データセットの準備を、より簡単かつ効率的に行うためのWindows向けアプリケーションです。
タグ編集、AIタグ付け、キャプション編集、AIキャプション生成、ファイル管理、画像トリミング、一括処理などを、1つの画面からまとめて行えます。
すべての機能を無料で利用できます。
---
## 主な機能
### タグ編集
- 画像ごとのタグ編集
- タグの追加 / 削除 / 置換 / 並び替え
- フォルダ全体へのタグ一括追加 / 一括削除
- タグのPrepend（先頭追加） / Append（末尾追加）
- タグ検索・抽出
- 現在のフォルダ内で使われているタグを確認できるタグプール
- 禁則 / NGタグ検出
### AI自動タグ付け
- WD14互換などのONNXモデルを利用したローカルAIタグ付け
- 信頼度閾値の調整
- 単一画像 / 一括タグ付け
- 進捗表示
- キャンセル対応
### AIキャプション生成
以下のキャプション生成エンジンに対応しています。
- Gemini
- OpenAI
- Florence-2
主な機能：
- 単一画像のキャプション生成
- 複数画像の一括キャプション生成
- キャプション詳細度の設定
- キャプション拡張子の変更
- キャプションの自動保存
- キャプション全文コピー
- 進捗表示
- 処理時間表示
- エラー表示
APIの利用制限やコンテンツ関連エラーにも対応し、不要なリクエストを避けつつ、詳細な情報をログへ保存します。
---
## データセットのファイル管理
LoRA Tagging Assistant では、画像ファイルと関連するメタデータファイルをひとまとまりとして扱います。
対応する主な関連ファイル：
- .txt タグファイル
- .caption キャプションファイル
画像をコピー / 移動 / リネーム / 削除する際、対応するタグ・キャプションファイルも連動して処理できます。
コピー先や移動先に同名ファイルが存在する場合は、以下から処理方法を選択できます。
- すべて置き換える
- 存在しないファイルだけ追加
- この画像セットをすべてスキップ
- キャンセル
同じ処理を、その後に発生する同名ファイルにも適用することもできます。
---
## 画像トリミング
内蔵のトリミング機能では、以下の操作に対応しています。
- トリミング範囲の指定
- 8方向のリサイズハンドル
- トリミング範囲の移動
- 安全なファイル置換
- 直前のトリミングを1回だけ元に戻すUndo機能
---
## ZIPエクスポート
画像・タグ・キャプションをまとめてZIP形式で書き出せます。
書き出し完了後、そのまま保存先フォルダを開くこともできます。
---
## UI
- 日本語 / 英語切替
- ライト / ダークテーマ
- 可動式パネルレイアウト
- サムネイル表示
- 画像プレビュー
- 画像情報表示
- お気に入りフォルダ
- アプリ内ヘルプ
- 診断ログへのアクセス
---
## ヘルプ
日本語版・英語版のヘルプを同梱しています。
アプリ内から、
ヘルプ → ヘルプ (使い方ガイド)
で開けます。
診断ログもヘルプメニューから直接開けます。
---
## 開発を応援する
LoRA Tagging Assistant は、すべての機能を無料で公開しています。
もし役に立ったと感じていただけたら、今後の開発・テスト・保守・機能改善を任意で応援していただけると嬉しいです。
Ko-fi:
ご支援は完全に任意です。
ご支援の有無による機能の違いはありません。
---
## 動作環境 / 配布形式
LoRA Tagging Assistant はWindows向けアプリケーションとして配布しています。
配布パッケージには実行に必要なファイルが含まれているため、別途Pythonをインストールする必要はありません。
AIタグ付け用のモデルファイルは、アプリケーションのリソースとして同梱されています。
Gemini / OpenAIによるキャプション生成を使用する場合は、ご自身のAPIキーが必要です。
Florence-2はローカルで動作します。
---
## 注意事項
重要なデータセットに対して一括処理を行う前には、念のためバックアップを取ることをおすすめします。
LoRA Tagging Assistant は今後も継続的に改善予定です。
今後のアップデートでは、タグ分類、フィルター強化、データセット検査などを予定しています。
Description
Version 3.0.4
Major update focused on caption generation, safer file management, cropping, and usability improvements.
■ Caption Features
- Added AI caption generation using Gemini, OpenAI, and Florence-2.
- Supports both single-image and batch caption generation.
- Added configurable caption detail level and caption file extension.
- Added automatic caption saving and a Copy button for caption text.
- Improved batch progress display, processing time, and average time per image.
■ API Error Handling
- Improved Gemini daily quota detection and stop behavior.
- Added detection for OpenAI quota / credit exhaustion.
- Temporary rate-limit errors are handled separately from quota exhaustion.
- Content-rejected images can be skipped while continuing the remaining batch.
- Detailed API responses are saved to logs while user-facing messages remain concise.
■ File Management
- .txt and .caption files now follow their corresponding image during copy, move, rename, and delete operations.
- Added improved same-name file handling:
- Replace All Files
- Add Missing Files Only
- Skip This Entire Image Set
- Cancel
- Added an option to apply the same conflict action to subsequent files.
- Improved rollback and cancellation safety.
■ Image Cropping
- Rebuilt the crop tool.
- Added 8-direction resize handles.
- Crop areas can now be moved by dragging.
- Improved crop-coordinate accuracy.
- Added one-level Undo Crop.
- Improved safe file replacement when saving cropped images.
■ UI / Usability
- Disabled unintended thumbnail drag-and-drop movement.
- Added image metadata display.
- Added “Open File Location” after ZIP export.
- Improved Japanese / English localization.
- Added in-app Markdown help in both Japanese and English.
- Added “Open Log Folder” to the Help menu.
■ Support
- Added an optional “Support Development” menu.
- All features remain completely free regardless of whether you choose to support development.
■ Other
- Improved cancellation handling for batch operations.
- Updated deprecated Qt6 mouse-event handling.
- Completed regression testing across tagging, captions, file operations, ZIP export, cropping, settings, language switching, and themes.
------------------------------------------------------------
Version 3.0.4
キャプション生成、ファイル管理の安全性、画像トリミング、操作性改善を中心とした大型アップデートです。
■ キャプション機能
- Gemini / OpenAI / Florence-2 によるAIキャプション生成に対応。
- 単一画像および複数画像の一括生成に対応。
- キャプションの詳細度設定、拡張子設定を追加。
- キャプションの自動保存、全文コピーボタンを追加。
- 一括処理時の進捗表示、処理時間、1枚あたりの平均処理時間を改善。
■ APIエラー処理
- Geminiの日次クォータ超過検出と停止処理を改善。
- OpenAIのクォータ不足 / クレジット不足を検出して即時停止。
- 一時的なレート制限と恒久的なクォータ不足を区別して処理。
- 特定画像のみがコンテンツ理由で拒否された場合、その画像だけを失敗として扱い、後続処理を継続。
- ユーザー向けの表示は簡潔にし、詳細なAPIレスポンスはログへ保存。
■ ファイル管理
- 画像のコピー / 移動 / リネーム / 削除時に、対応する .txt / .caption ファイルも連動処理。
- 同名ファイルが存在する場合の処理を改善。
- すべて置き換える
- 存在しないファイルだけ追加
- この画像セットをすべてスキップ
- キャンセル
- 以降の同名ファイルにも同じ処理を適用するオプションを追加。
- コピー / 移動時のキャンセルおよびロールバック処理を改善。
■ 画像トリミング
- トリミング機能を再構築。
- 8方向のリサイズハンドルを追加。
- 選択範囲全体のドラッグ移動に対応。
- トリミング座標処理を改善。
- 直前のトリミングを1回だけ元に戻せるUndo機能を追加。
- 保存時のファイル置換処理をより安全な方式に改善。
■ UI / 操作性
- サムネイルの意図しないドラッグ＆ドロップ / 自由移動を無効化。
- 画像情報表示を追加。
- ZIPエクスポート完了後に「ファイルの場所を開く」を追加。
- 日本語 / 英語表示の細かな不整合を修正。
- 日本語 / 英語対応のアプリ内Markdownヘルプを追加。
- ヘルプメニューに「ログフォルダを開く」を追加。
■ 開発支援
- 任意の「開発を応援する」メニューを追加。
- ご支援の有無による機能差はありません。すべての機能を無料で利用できます。
■ その他
- 一括処理のキャンセル挙動を改善。
- Qt6で非推奨となったマウスイベント処理を更新。
- タグ編集、キャプション、ファイル操作、ZIP出力、トリミング、設定保存、言語切替、テーマ切替など各種リグレッションテストを実施。