Miniforge 安装 + labelme 配置一站式教程

【深度学习标注神器】Miniforge 安装 labelme 配置一站式教程替代 Anaconda摘要Anaconda 商用受限后Miniforge基于 conda-forge 的轻量发行版成为新的首选。本文将带你完成 Miniforge 的下载安装、镜像加速、虚拟环境创建并在该环境中安装图像标注工具labelme最后给出一个真实的多边形标注 demo。一、为什么不再用 Anaconda2024 年起 Anaconda 商业用途需付费授权Miniforge 默认源就是conda-forge社区维护、包更新更快安装包仅 60MB 左右比 Anaconda 小 10 倍工具大小默认源商用Anaconda~700MBdefaults200 人以上企业需付费Miniconda~80MBdefaults同上Miniforge~60MBconda-forge完全免费二、安装 MiniforgeLinux / WSL / macOS1. 下载安装脚本进入 Miniforge GitHub Release 页 下载对应平台脚本或一键命令# Linux x86_64wgethttps://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-x86_64.sh# macOS Apple Siliconwgethttps://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-arm64.sh国内访问 GitHub 慢可以挂代理或使用镜像https://mirrors.tuna.tsinghua.edu.cn/github-release/conda-forge/miniforge/2. 执行安装bashMiniforge3-Linux-x86_64.sh按提示一路回车阅读许可按q跳过 输入yes选择安装路径默认~/miniforge3是否运行conda init→输入 yes3. 激活并验证source~/.bashrc conda--version# 输出conda 24.x.x4. 可选关闭每次进入终端自动激活 baseconda config--setauto_activate_basefalse5. 配置国内镜像清华源编辑~/.condarcchannels:-defaultsdefault_channels:-https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main-https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/rcustom_channels:conda-forge:https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloudpytorch:https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud刷新缓存conda clean-i三、创建 labelme 虚拟环境 不要把 labelme 装进 base单独环境便于隔离 Qt 依赖。conda create-nlabelmepython3.10-yconda activate labelme四、安装 labelme方式 Apip 安装推荐版本最新pipinstalllabelme-ihttps://pypi.tuna.tsinghua.edu.cn/simple方式 Bconda-forge 安装condainstall-cconda-forge labelme-y验证labelme--version# 输出5.x.x启动labelme弹出 GUI 窗口即安装成功。下图为官方提供的 labelme GUI 标注交互演示图片来源labelme 官方仓库 README (GPL-3.0 / 用户上传的 GitHub user-images)五、labelme 实战标注一张图片点击左上角Open打开一张图片菜单 →Edit → Create Polygons快捷键CtrlN沿目标轮廓点击鼠标左键描边闭合后输入类别名如catCtrlS保存会在图片同目录生成同名.json完成多边形标注后的效果示例labelme 官方实例分割 demo图片来源labelme/examples/instance_segmentation (GPL-3.0)JSON 输出示例{version:5.4.1,shapes:[{label:cat,points:[[120,80],[340,80],[340,260],[120,260]],shape_type:polygon}],imagePath:cat.jpg,imageHeight:480,imageWidth:640}转换为 mask / VOC / COCO 格式labelme 自带脚本# 单张转 masklabelme_json_to_dataset cat.json-ocat_json# 批量转 VOCpython-mlabelme.cli.export_json2voc input_dir output_dir六、常见问题❶qt.qpa.plugin: Could not load the Qt platform plugin xcb缺少系统 Qt 依赖sudoaptinstalllibxcb-xinerama0 libxkbcommon-x11-0-yWSL 用户需要安装 X Server如 VcXsrv / WSLg。❷ 中文路径乱码 / 中文标签报错把图片路径改为全英文labelme 5.x 已支持中文标签但路径仍建议 ASCII。❸ 想升级 labelmepipinstall-Ulabelme七、写在最后Miniforge labelme 的组合既绕开了 Anaconda 商用许可又有完整 GUI 标注体验非常适合 CV / 自动驾驶 / 医学影像方向的同学。如果觉得有用请点赞收藏下一篇我们将讲labelme json → YOLO/COCO 数据集脚本一键转换。参考资料Miniforge 官方仓库: https://github.com/conda-forge/miniforgelabelme 官方仓库: https://github.com/wkentaro/labelme清华大学 conda 镜像使用帮助: https://mirrors.tuna.tsinghua.edu.cn/help/anaconda/Anaconda 商用授权说明: https://www.anaconda.com/blog/anaconda-commercial-edition-faqQt xcb 插件问题: https://stackoverflow.com/questions/56158361图片版权说明本文 labelme logo、GUI 演示 GIF、多边形标注示例均取自 labelme 官方仓库遵循 GPL-3.0 协议转载已注明出处。