Skip to main content

LabelCraft - Modern Image Annotation Tool

LabelCraft is a powerful and user-friendly graphical image annotation tool, enhanced from the popular labelImg project. It provides an intuitive interface for creating bounding box annotations for object detection and machine learning tasks.

✨ Key Features

  • Multiple Format Support: Export annotations in PASCAL VOC (XML), YOLO (TXT), CreateML (JSON), COCO (JSON), and CSV formats
  • Project Management: Create and manage annotation projects with organized directory structures
  • Smart Workflow: Pending queue system for efficient batch annotation
  • Multi-language Support: English, Simplified Chinese, Traditional Chinese, Japanese, German, French
  • Image Enhancement: Real-time brightness adjustment for better visibility
  • Flexible Navigation: Zoom, pan, and keyboard shortcuts for fast annotation
  • Predefined Classes: Load and manage custom class labels
  • Annotation Verification: Mark verified annotations for quality control
  • Dark/Light Mode: Automatic theme adaptation for comfortable viewing
  • Auto-save: Optional automatic saving when switching images
  • Cross-platform: Works on Windows, macOS, and Linux

🚀 Quick Start

Installation


Install via pip::

    pip install labelcraft

Or run from source::

    git clone https://github.com/syd168/LabelCraft.git
    cd LabelCraft
    pip install -r requirements.txt
    python main.py

Usage
~~~~~

Basic usage::

    labelcraft                              # Start without parameters
    labelcraft /path/to/images              # Open images from directory
    labelcraft --classes classes.txt        # Use custom class file
    labelcraft --save-dir ./output          # Set default save directory
    labelcraft --version                    # Show version

Command-line Options
  • image_dir: Directory containing images to annotate (optional)
  • --classes, -c: Path to predefined classes file
  • --save-dir, -s: Default directory to save annotations
  • --version, -v: Display program version

📖 Documentation

For detailed tutorials and documentation, visit:

  • GitHub Repository <https://github.com/syd168/LabelCraft>_
  • Installation Guide <https://github.com/syd168/LabelCraft/blob/master/doc/安装标注工具.md>_
  • Tutorial (English) <https://github.com/syd168/LabelCraft/blob/master/doc/tutorial.md>_
  • Tutorial (中文) <https://github.com/syd168/LabelCraft/blob/master/doc/tutorial_zh-CN.md>_

🛠️ Development

Requirements


- Python 3.8 or higher
- PySide6 >= 6.5.0
- lxml >= 4.9.0

Install dependencies::

    pip install pyside6>=6.5.0 lxml>=4.9.0

💡 Tips
------

- Press ``W`` to start drawing bounding boxes
- Use ``D`` and ``A`` to navigate between images
- Press ``Space`` to verify current annotation
- Use mouse wheel to zoom, drag to pan
- Adjust brightness with Ctrl+Shift+[/]

📄 License
---------

MIT License - See LICENSE file for details

🙏 Acknowledgments
-----------------

This project is based on the original `labelImg <https://github.com/tzutalin/labelImg>`_ by TzuTa Lin.

Note: This project is actively maintained and enhanced with modern features.


History

1.8.16 (2026-04-13)
-------------------

* Fixed IndexError when editing project configuration
* Enhanced i18n module: Added escape sequence decoding for properties files
* Fixed multi-line string parsing in resource files (\n, \t, \\)
* Optimized project edit warning dialog display logic
* Improved code robustness and maintainability

1.8.15 (2026-04-12)
-------------------

* Removed Close and Save As menu items for streamlined workflow
* Added batch label input feature in project creation/editing dialog
* Enhanced label input: support paste from Excel with auto-parse
* Added "Batch Add" button for convenient multi-label addition
* Improved user experience: press Enter to add labels instantly
* Smart duplicate detection when adding multiple labels
* Updated multi-language strings for new features

1.8.8 (2025-04-12)
------------------

* Fixed i18n: Added get_str() instance method for all dialogs
* Fixed export: Enhanced image path detection for YOLO and CSV formats
* Fixed export: Added SameFileError check when copying images
* Fixed project close: Auto-save current image annotation before closing
* Updated start scripts to English output for international users
* Improved README with pip installation guide
* Removed deprecated language files (fa-FA, de-DE)
* Enhanced annotation converter with multi-location image search

1.8.7 (2024-XX-XX)
------------------

* Based on labelImg project
* Added modern UI improvements
* Enhanced multi-language support
* Added brightness adjustment feature
* Improved annotation workflow
* Added GitHub Actions CI/CD

Note: This project is a fork and enhancement of the original labelImg project.
=======

1.8.6 (2024-XX-XX)
------------------

* Based on labelImg project
* Added modern UI improvements
* Enhanced multi-language support
* Added brightness adjustment feature
* Improved annotation workflow
* Added GitHub Actions CI/CD

Note: This project is a fork and enhancement of the original labelImg project.

Metadata

Release files for LabelCraft 1.8.16

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for LabelCraft 1.8.16
File Size Uploaded Provenance Actions
labelcraft-1.8.16.tar.gz 2.3 MB Without provenance Details for labelcraft-1.8.16.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for LabelCraft 1.8.16
File Interpreter ABI Platform Actions
labelcraft-1.8.16-py2.py3-none-any.whl Python 2, Python 3 none any Details for labelcraft-1.8.16-py2.py3-none-any.whl

Total release size: 3.8 MB

Release files / labelcraft-1.8.16.tar.gz

Download URL labelcraft-1.8.16.tar.gz
Size 2.3 MB
Tags Source
SHA-256 checksum
How to use checksums
8945f8713002e4e338ab6b4b02bd1a5ba6e2107866a77254a26955e6605775dc
BLAKE2b-256 checksum
How to use checksums
c5f02f8e1213bc7dcea0f127ebc2eb975fedaf30932c17c159041930c2728490
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / labelcraft-1.8.16-py2.py3-none-any.whl

Download URL labelcraft-1.8.16-py2.py3-none-any.whl
Size 1.5 MB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
ddd03da8aa9eec0da272948b470851001b9cf5dbbfa5e2a018ee590a9b9af024
BLAKE2b-256 checksum
How to use checksums
349fcb064b51878809bb79094e1cda6f60a251aff9b5e28da71a9a975c75f26d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Security for LabelCraft 1.8.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page