taggui

环境要求

• Windows 或 Linux 桌面系统（官方未提供 macOS 发行版，需手动安装运行）
• Python 3.12（推荐），Python 3.11 也可用（手动安装方式需要）
• 手动安装需能访问 GitHub 克隆仓库并安装 requirements.txt 中的依赖
• Linux 用户可能需要额外安装 libxcb-cursor0

安装与启动步骤

1. 1下载发行版

   打开项目 releases 页面，按操作系统选择对应文件下载；这是最省事的安装方式，macOS 没有对应发行版。

2. 2解压文件

   把下载的压缩包解压到任意目录；若系统没有解压工具，需先安装 7-Zip 再解压。

3. 3运行可执行文件

   进入解压后的目录，双击运行其中的可执行文件即可启动图形界面。

4. 4克隆仓库（手动安装）

   不想用发行版可手动安装：先把仓库克隆到本地任意目录。

   git clone https://github.com/jhc13/taggui.git

   复制

5. 5安装依赖

   进入仓库目录，安装 requirements.txt 中列出的全部依赖。

   cd taggui
   pip install -r requirements.txt

   复制

6. 6启动程序

   运行仓库内的 run_gui.py 启动图形界面，官方推荐 Python 3.12。

   python taggui/run_gui.py

   复制

7. 7Linux 补依赖

   Linux 上若启动报错，需额外安装系统库 libxcb-cursor0 再重新运行程序。

   sudo apt install libxcb-cursor0

   复制

如何确认成功

程序窗口正常打开，点击窗口中央的 Load Directory 按钮能成功加载图片目录即表示启动成功。

常见问题

注意事项

• 建议把待标注图片统一放在一个目录中，方便用 Load Directory 一次性加载。
• 标签改动会自动保存到与图片同名的 .txt 文件，操作前注意备份原始标签。
• 手动安装前先确认 pip 与 Python 版本，避免依赖安装失败。