LabelCraft - Intelligent Image Annotation Tool

Version 3.0.2 — Project-first annotation for detection & pose, based on labelImg

中文文档 | English

LabelCraft is a graphical image annotation tool with project management, multi-shape drawing, and YOLO-Pose support. It is a major evolution of labelImg — thanks to TzuTa Lin for the original work.

Highlights (v3.0)

• Shapes: rectangle, pose (bbox + keypoints), polygon, ellipse, circle
• Projects: .lbc project files (legacy .labelcraft still opens), detect / pose tasks
• Import / Export: LabelCraft JSON, YOLO Detect, YOLO Pose, PASCAL VOC, CreateML, COCO, CSV
• Workflow: pending queue, completed list, verify status, auto-save, default label
• UI: compact project info panel, cleaned menus & shortcuts, taskbar app icon
• i18n: English, 简体中文, 繁體中文, 日本語, Deutsch, Français (live switch)

Screenshot

Install

pip (recommended)

pip install -U labelcraft
labelcraft

From source

git clone https://github.com/syd168/LabelCraft.git
cd LabelCraft
python3 -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install -r requirements.txt
pyside6-rcc -o libs/resources.py resources.qrc   # if you change icons
python main.py

Or use ./start.sh (Linux/macOS) / start.bat (Windows).

Quick workflow

1. File → New Project (Ctrl+N) — name, location, labels, detect or pose
2. Add images / folders into the pending queue
3. Draw with W (rect), P (pose), G (polygon), E (ellipse), C (circle)
4. Ctrl+S save annotation · Ctrl+Alt+S save project
5. Data → Export… (Ctrl+Shift+E) when ready

Project files use {name}.lbc. Annotations live under {project_dir}/annotations/.

Keyboard shortcuts (common)

See Help → Shortcuts in the app for the full list.

Project layout

LabelCraft/
├── main.py              # Entry
├── labelcraft_ui.py     # Main window
├── libs/                # Core (project, canvas, I/O, i18n, …)
├── resources/           # Icons & assets
├── requirements.txt
└── setup.py             # PyPI packaging

Development notes

• Python 3.8+, dependency: PySide6 ≥ 6.5, lxml
• Locales: libs/locales/*.json
• After editing resources.qrc, recompile:
  pyside6-rcc -o libs/resources.py resources.qrc

Changelog (3.0.2)

• Fix shape-style fill opacity: 100% is fully opaque again (removed accidental alpha clamp)

Changelog (3.0.1)

• PyPI description: use absolute screenshot URL so the image renders on pypi.org

Changelog (3.0.0)

See RELEASE_NOTES_v3.0.0.md.

License

MIT — see LICENSE.

Acknowledgments

• labelImg by TzuTa Lin
• Contributors and users of LabelCraft