# labelImg

**Repository Path**: tekintian/labelImg

## Basic Information

- **Project Name**: labelImg
- **Description**: labelImg是一款专为计算机视觉任务设计的图形化图像标注工具。它提供了直观的界面，用于在图像上创建边界框标注，支持Pascal VOC和YOLO等多种标注格式。 该工具基于PyQt构建，易于安装和使用，适用于各种图像标注需求。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-05
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# labelImg - 图像标注工具

[English Version](README_EN.md)

## 概述

labelImg是一款专为计算机视觉任务设计的图形化图像标注工具。它提供了直观的界面，用于在图像上创建边界框标注，支持Pascal VOC和YOLO等多种标注格式。 该工具基于PyQt构建，易于安装和使用，适用于各种图像标注需求。

## 🆕 AI 辅助标注功能

现已支持基于深度学习的 AI 辅助批量标注！支持 YOLOv8、YOLO11、YOLO26 等最新模型。

- **快速开始**: [docs/AI_QUICKSTART.md](docs/AI_QUICKSTART.md)
- **详细指南**: [docs/AI_LABEL_GUIDE.md](docs/AI_LABEL_GUIDE.md)
- **YOLO26 支持**: [docs/AI_YOLO26_SUPPORT.md](docs/AI_YOLO26_SUPPORT.md)

## 功能特点

- **AI 辅助标注**：
  - 支持 YOLOv8/YOLO11/YOLO26 等最新模型
  - 单张/批量自动标注
  - 可配置置信度阈值和模型参数
  - 专为边缘设备优化的 YOLO26（CPU 推理快 43%）
- **用户友好的界面**：基于PyQt构建的简洁直观的GUI
- **多种标注格式支持**：
  - Pascal VOC XML格式
  - YOLO格式
- **多语言支持**：英文、简体中文、繁体中文
- **可定制化**：调整颜色、标签和绘制偏好
- **键盘快捷键**：使用键盘命令实现高效工作流
- **文件管理**：批量处理目录中的图像

## 安装

### 前置条件

- Python 3.x
- PyQt5 或 PyQt4
- 所需Python包：`PyQt5`、`resources`（从resources.qrc生成）

### 安装步骤

1. **克隆仓库**：
   ```bash
   git clone https://github.com/tekintian/labelImg.git
   cd labelImg
   ```

2. **安装依赖**：
   ```bash
   pip install -r requirements.txt
   ```

3. **生成资源文件**（如果需要）：
   ```bash
   pyrcc5 -o resources.py resources.qrc
   ```

4. **运行应用**：
   ```bash
   python labelImg.py
   ```

## 使用指南

### 基本操作

1. **打开图像**：点击"打开"或按`Ctrl+O`打开图像文件
2. **创建标注**：
   - 选择"创建矩形框"或按`W`
   - 在对象周围绘制矩形
   - 为对象输入标签
3. **AI 自动标注** (新功能)：
   - 点击菜单 **AI** → **AI Auto Label** (`Ctrl+K`)
   - 或点击菜单 **AI** → **AI Batch Label** (`Ctrl+Shift+K`) 批量处理
   - 首次使用前请在 **AI** → **AI Settings** 中配置模型
4. **保存标注**：点击"保存"或按`Ctrl+S`
5. **下一张/上一张图像**：使用`D`（下一张）和`A`（上一张）浏览图像

### 键盘快捷键

- `Ctrl+O`：打开图像
- `Ctrl+S`：保存标注
- `W`：创建矩形框
- `D`：下一张图像
- `A`：上一张图像
- `Delete`：删除选中的标注
- `Ctrl++`：放大
- `Ctrl+-`：缩小
- `Ctrl+Q`：退出
- `Ctrl+K`：AI 自动标注（单张）
- `Ctrl+Shift+K`：AI 批量标注

### 支持的标注格式

#### Pascal VOC XML格式
```xml
<annotation>
  <filename>image.jpg</filename>
  <object>
    <name>person</name>
    <bndbox>
      <xmin>100</xmin>
      <ymin>200</ymin>
      <xmax>300</xmax>
      <ymax>400</ymax>
    </bndbox>
  </object>
</annotation>
```

#### YOLO格式
```
0 0.5 0.5 0.4 0.3
```
- 类别ID, x中心, y中心, 宽度, 高度（归一化坐标）

## 项目结构

```
labelImg/
├── labelImg.py              # 主应用入口点
├── resources.py             # 编译后的资源（从resources.qrc生成）
├── resources.qrc            # Qt资源文件
├── setup.py                 # 安装设置
├── docs/                   # 📁 文档目录
│   ├── AI_QUICKSTART.md     # AI 功能快速开始指南
│   ├── AI_FEATURE_README.md # AI 功能详细介绍
│   ├── AI_LABEL_GUIDE.md    # AI 标注详细使用指南
│   ├── AI_CHANGELOG.md      # AI 功能更新日志
│   ├── AI_YOLO26_SUPPORT.md # YOLO26 支持说明
│   └── AI_IMPLEMENTATION_SUMMARY.md # 实现总结
├── libs/                    # 核心库
│   ├── canvas.py            # 绘图画布
│   ├── labelFile.py         # 标注文件处理
│   ├── shape.py             # 形状定义
│   ├── pascal_voc_io.py     # Pascal VOC格式支持
│   ├── yolo_io.py           # YOLO格式支持
│   ├── ai_inference.py      # AI 推理引擎
│   ├── auto_label_dialog.py # AI 配置对话框
│   ├── stringBundle.py      # 国际化
│   ├── settings.py          # 应用设置
│   └── ...                  # 其他UI组件
├── resources/               # 资源目录
│   ├── icons/               # 应用图标
│   └── strings/             # 翻译文件
└── tests/                   # 测试文件
```

## 自定义

### 添加自定义标签

1. 编辑`data/predefined_classes.txt`文件
2. 每行添加一个自定义标签
3. 重启应用

### 更改颜色

1. 点击"视图"→"框线颜色"
2. 选择您喜欢的颜色
3. 新颜色将应用于所有新标注

### 语言设置

1. 点击菜单中的"语言"
2. 选择您喜欢的语言（英文、简体中文、繁体中文）
3. 重启应用使更改生效

## 故障排除

### 常见问题

1. **缺少字符串资源**：确保从`resources.qrc`正确生成了`resources.py`文件
2. **PyQt导入错误**：确保已安装正确版本的PyQt（推荐使用PyQt5）
3. **标注格式问题**：检查您是否使用了适合您用例的正确格式

## 贡献

欢迎贡献！请按照以下步骤：

1. Fork仓库
2. 创建功能分支（`git checkout -b feature/your-feature`）
3. 提交更改（`git commit -am 'Add some feature'`）
4. 推送到分支（`git push origin feature/your-feature`）
5. 创建新的Pull Request

## 许可证

本项目采用MIT许可证 - 有关详细信息，请参阅LICENSE文件。

## 致谢

本项目是[HumanSignal/labelImg](https://github.com/HumanSignal/labelImg)的升级版本。我们衷心感谢原作者和贡献者的基础工作。由于原始项目已过时且不再维护，我们决定创建这个更新版本以继续支持社区。

- 基于tzutalin和HumanSignal的原始labelImg工具
- 感谢所有贡献者的宝贵工作
- 图标由各种开源图标集提供

## 联系方式

如有问题、疑问或建议，请在GitHub仓库上打开一个issue。

## 定制开发

如果您需要根据特定需求定制开发各类应用或者工具，我们欢迎您联系我们。请通过以下方式联系我们：
- 邮箱：tekintian@gmail.com
- Website：https://dev.tekin.cn/
- QQ：932256355

**愉快标注！** 🎯