开源免费 · MIT License · 开箱即用

卜一慧眼
给产线装上一双
看得懂缺陷的眼睛

BYOE-VISION · BRING YOUR OWN EYE

低代码工业视觉开发平台:拖拽节点搭流水线,用自己的样本二次训练,逐节点断点调试,一键打包成带界面的独立程序或无头推理服务 — 全程不用写一行代码。


pip install byoe-vision[all]

不只是一个视觉工具,
是一套完整的开发平台

从搭建、训练、调试到交付运维,工业视觉项目的每个环节都在平台内闭环。

拖拽式开发

60+ 种视觉节点、16 个分类:取图、预处理、异常检测、卡尺测量、仪表读数、OCR、判定、网络输出。拖拽连线即成流水线,60 多种节点的手册由 AI 助手随时解答。

二次训练

用自己的样本在 GUI 里重训模型,无需写代码:免标注异常检测(PatchCore / 自编码器)+ YOLO 全任务(检测 / 旋转框 / 分割 / 分类)。阈值自动标定,训练进度实时可视。

断点调试

像调试程序一样调试视觉流水线:逐节点查看中间图像与数据,TIMING 面板给出每个节点的耗时分解,OUTPUT / DEBUG / LOGS 面板实时滚动运行状态,问题节点一眼定位。

双形态打包分发

开发完一键导出两种成品:带界面的独立程序(可最小化到系统托盘常驻采集)和无头推理服务(FastAPI / CLI,带鉴权与 Prometheus 指标)。体积小,可直接装进嵌入式边缘设备。

从相机到业务系统,一条流水线打通

采集、处理、检测、判定、输出全部节点化 — 换产品 = 换一条流水线,而不是换一套代码。

多源采集 相机 / 文件夹 / 屏幕捕获 流水线引擎 60+ 节点 · DAG 调度 · 断点调试 撤销重做 · JSON 序列化 模型训练 PatchCore / AE / YOLO 带界面程序 独立 exe · 托盘常驻 无头推理服务 FastAPI / CLI · 嵌入式 检测 / 测量能力 异常检测 · 目标检测 · 卡尺 · Blob · OCR · 仪表读数 判定与输出 OK/NG · 热力图 · 报表 业务系统集成 MQTT 发布订阅 · HTTP 上报 · REST API · WebSocket 实时流 · Prometheus 指标

模型训练产物直接被流水线引用;打包成品可脱离平台独立运行,并反向接入客户的 MES / PLC 业务系统。

一个平台,覆盖从想法到交付的完整生命周期

拖拽开发 · 二次训练 · 断点调试 · 打包分发 — 四大能力逐个展开。

拖拽式开发:搭流水线,不写代码

从左侧节点库拖出模块、连线成 DAG、点 Run — 一条检测流水线就建好了。60 多种节点覆盖工业视觉的主流任务,画布支持实时预览、撤销重做和 JSON 序列化。

  • 16 大类节点:预处理、颜色、ROI、定位、异常检测、判定、输出、边缘测量、仪表读数、几何、斑点分析、模板匹配、目标检测、文字/OCR、网络等
  • 每个节点带悬浮帮助卡片与默认参数,新手不需要先读文档
  • 节点可折叠分组与搜索过滤,节点再多也不迷路
  • 流水线即 JSON — 版本管理、复用、AI 生成全都顺畅
拖拽式流水线画布

一条真实的流水线长什么样?

示例:瓶身表面缺陷检测(内置例程 anomaly_defect)— 这正是本站截图里跑通的那条。

Source Image 读取产线相机图 Anomaly Detection PatchCore 模型推理 Heatmap Output 缺陷热力图叠加 Threshold Verdict OK / NG 判定 MQTT / HTTP 输出 推送 MES / PLC

换产品 = 拖一条新流水线;节点参数即配置,不需要重写任何代码。

二次训练:你的样本,你的模型

在 GUI 的「模型」页选好样本文件夹点训练即可 — 没有脚本、没有命令行、没有超参炼丹。训练完的模型自动进入模型库,流水线节点直接引用。

  • PatchCore — 免标注异常检测:只用正常样本,缺陷自动上热力图(MVTec 15 类基准 Image AUROC 平均 0.962)
  • 卷积自编码器 — 重建误差路线,与 PatchCore 互补,适合细微几何缺陷
  • YOLO 全任务 — 检测 / 旋转框 / 分割 / 分类,一次讲清四个任务
  • 判定阈值按正常样本分数自动标定(99.5 分位),不是拍脑袋

消费级显卡即可训练:实测 RTX 4070 Ti SUPER 上 PatchCore 建库 209 图约 90 秒,YOLO nano 单 epoch 106 秒、峰值显存仅 1.8 GB。

模型管理页

断点调试:像调程序一样调流水线

视觉项目最怕"结果不对,但不知道哪一环不对"。慧眼把流水线当成程序来调试:

  • TIMING — 每次运行一条记录,每个节点耗时一目了然(实测瓶颈立现)
  • OUTPUT — 逐节点查看中间图像与数据,热力图、检测框即时预览
  • DEBUG / LOGS / WARNINGS / ERRORS — 全量运行痕迹,异常节点精准定位
  • 对单个模块点击 ▾ 即可单独运行该节点,所见即所得
TIMING 调试面板

打包分发:开发一次,两种形态交付

成品不依赖 Python 环境与平台本体,体积小到可以装进嵌入式边缘设备;也能以服务形态与业务系统长期共存。

卜一慧眼 开发平台 设计 · 训练 · 调试完成的流水线 形态 A · 带界面程序 PyInstaller 独立 exe 系统托盘常驻 · 结果看板 · 定时采集 形态 B · 无头推理服务 CLI run/batch/watch + FastAPI serve Docker 友好 · 可进嵌入式边缘设备 边缘侧 工控机 / 嵌入式盒子 / 产线工位机 离线运行 · 断网可用 业务系统侧 MES / PLC / 数据平台 MQTT · HTTP · REST · WebSocket
byoe-vision CLI — 无头运行 / 服务化
$ byoe-vision run bottle_defect.json D:/images/ # 单张 / 目录批跑 Pipeline done — verdict: DEFECT (score 0.897, 183 ms) $ byoe-vision watch bottle_defect.json D:/drop_folder/ --csv out.csv # 文件夹监控 $ byoe-vision serve --port 8000 # 起推理服务 INFO: Uvicorn running on http://0.0.0.0:8000 (REST / WebSocket / Prometheus /metrics)

60+ 节点,16 大类

以下是常用节点速览,完整清单可在平台内查看(每个节点带帮助卡片与默认参数)。

分类代表节点用途
异常检测AnomalyDetection(PatchCore / 自编码器)免标注缺陷检测,输出分数与热力图
目标检测ObjectDetect · ImageClassifyYOLO 检测 / OBB / 分割 / 分类结果进流水线
边缘测量Caliper 系列 · CircleFit边缘卡尺、圆拟合、距离与角度测量
仪表读数指针表 · 七段码 · 游标卡尺老仪表数字化读数
定位Fixture · TemplateMatch定位纠偏、模板匹配,姿态变化不再影响检测
预处理阈值 · 形态学 · 对比度 · 颜色阈值光照稳定化与目标分离
判定ThresholdVerdict · CountVerdict · Combine分数 / 数量 / 多条件组合成 OK-NG
文字 / OCROCR · 条码 · 二维码 · 文字匹配喷码校验、批次识别
网络MqttPublish · MqttSubscribe · HttpPost / HttpGet结果上报与远程指令,直连业务系统
输出热力图 · 标注图 · PDF 报表 · CSV 导出人看的结果与机器用的数据同时产出

内置 AI 助手,还开放 MCP Server

画布旁边就有 AI 助手:查节点手册、解释报错、帮你搭线。平台同时内置 MCP Server,把 8 个工具开放给任意 MCP 客户端(Codex CLI、OpenCode、Cursor 等)— 你可以用一句话让 AI 替你搭流水线。

  • 8 个结构化工具:查节点手册、载入例程、校验、试跑、存取流水线、查模型库
  • 校验闭环:AI 生成的流水线先过结构化校验,错误自纠后才落地
  • 路径沙箱:所有文件操作限制在工作目录内
内置 AI 助手面板

开发、调试、训练、交付,一屏尽览

以下均为平台实际运行截图(示例:瓶身表面缺陷检测,模型由 209 张正常样本训练)。

byoe-vision-gui · 流水线画布
拖拽式流水线画布:节点库、连线与实时运行结果
拖拽式流水线画布 — 左侧 16 类节点库,中间 DAG 连线,右侧实时输出:DEFECT 判定 + 缺陷热力图,整条流水线 183.6 ms。
byoe-vision-gui · TIMING 面板
TIMING 调试面板:每次运行的耗时记录
断点调试与耗时分析 — TIMING 面板记录每次运行、每个节点的耗时;配合 DEBUG / LOGS 面板逐节点排查。
byoe-vision-gui · 模型管理
模型管理页:已训练模型、阈值与激活状态
二次训练与模型管理 — 选样本文件夹即可训练;阈值自动标定(0.527),模型一键激活供流水线引用。
byoe-vision-gui · 屏幕设计器
屏幕设计器:工业组态控件与数据绑定
屏幕设计器(HMI) — 工业组件 + 数据绑定,把检测结果组态成操作工看得懂的车间看板。
60+
内置视觉节点
29
开箱即用例程
3 类
可二次训练模型
920+
自动化回归测试
MIT
完全开源免费

一台工位一个难题,拖一条流水线解决

🔍 表面缺陷检测

免标注异常检测:只用正常样本建模,划痕、崩边、污染自动上热力图,OK/NG 自动判定。

🎯 目标检测与计数

YOLO 检测 / 旋转框 / 分割 / 分类四任务,训练完直接进流水线做存在性、数量判定。

📏 尺寸与位置测量

卡尺、圆拟合、标定节点输出物理坐标,公差判定自动给出 PASS / FAIL。

🎛️ 仪表与数码管读数

指针表、七段码、游标卡尺专用读数节点,老设备不改造成本即可接入数据系统。

🔤 字符 / 条码识别

OCR、条码、二维码节点配合文字匹配判定,做喷码错漏与批次校验。

🏭 接入业务系统

MQTT / HTTP 节点直连 PLC、MES;无头服务暴露 REST API 与 WebSocket 实时流。

「慧眼识瑕,毫厘毕现」
卜一慧眼 — Bring Your Own Eye
开源免费的低代码工业视觉开发平台 · vision.byoe.net

三步上手,当天出结果

快速上手指南

安装 → 打开例程 → 换上你的样本训练 → 打包交付,全流程图文。

打开指南

平台能力详解

四大能力逐个展开:节点清单、训练实测、调试面板、双形态分发。

查看平台能力

直接安装

PyPI 一条命令装齐全部能力,含 GUI、训练与推理服务。

pip install byoe-vision[all]

从安装到交付,五个步骤

安装 → 跑通例程 → 换上你的样本 → 训练 → 打包分发。全程不需要写代码;需要 Python 3.10+ 与一块普通显卡(CPU 也能跑)。

安装:一条命令

推荐安装完整版(含 GUI、训练、推理服务)。最小化安装见文末说明。

Windows / Linux / macOS
$ python -m venv .venv # 建议先建虚拟环境 $ pip install byoe-vision[all] Successfully installed byoe-vision … $ byoe-vision-gui # 启动图形界面 提示:GPU 训练需另装 CUDA 版 PyTorch;CPU 环境开箱即可运行推理。

跑通第一条流水线:从 29 个例程里挑一个

文件菜单 → Examples,选择一个例程(瓶身缺陷检测、指针仪表读数、游标卡尺、七段码、模板匹配定位……),点 Run 立即出结果。建议先跑「Anomaly — Defective bottle」看热力图效果。

例程:瓶身缺陷检测 — 运行结果
例程运行结果

🔍 缺陷检测类

anomaly_defect / anomaly_pass — 同一模型分别看坏品与好品,理解阈值含义。

🎛️ 读数测量类

analog_gauge / seven_segment_lcd / vernier_caliper — 指针表、数码管、卡尺读数。

📐 定位计数类

template_match / fixture / blob_count — 模板定位、纠偏、斑点计数判定。

你自己的样本训练模型

不需要缺陷样本 — 收集 100~300 张正常品图片,按文件夹存放即可开始。

1

准备正常样本

把产线上顺手存的 OK 品图放进一个文件夹(光照、工位保持稳定)

2

模型页新建训练

「模型」标签 → 新建训练 → 方法选 PatchCore → 指定样本文件夹

3

等待训练完成

几百张图分钟级完成;阈值自动按 99.5 分位标定

4

流水线里引用

异常检测节点的预设下拉里选刚训的模型,Run 即可检测

模型页:训练完成后的模型库
训练完成的模型库
实测参考 — 209 张正常样本建库约 90 秒(RTX 4070 Ti SUPER),83 张测试图 Image AUROC 1.000;YOLO nano 单 epoch 106 秒、峰值显存 1.8 GB。

调试与调优:每个节点都看得见

结果不对时:点开 TIMING 看哪个节点慢、OUTPUT 看每个节点的中间图像、DEBUG 看数据流向 — 定位到节点后改参数重跑,秒级验证。

TIMING / DEBUG 面板
调试面板

交付:两种形态随便选

给操作工用 → 打包成带界面的独立程序(可托盘常驻);给业务系统用 → 无头服务 + REST API / MQTT 上报。成品不需要安装 Python。

交付形态速览
# 形态 A:带界面独立程序(GUI 内导出,PyInstaller 打包) viewer.exe — 拖入流水线 JSON 即运行,可最小化到系统托盘持续采集 # 形态 B:无头推理服务(CLI / Docker / 嵌入式边缘设备) $ byoe-vision run pipeline.json image.png # 单图 $ byoe-vision batch pipeline.json D:/images/ --csv r.csv # 批量 $ byoe-vision watch pipeline.json D:/hotfolder/ # 文件夹监控 $ byoe-vision serve --port 8000 # REST / WebSocket / Prometheus

部署时还支持 --set 节点.参数=值 运行时配置覆盖与 diagnose 远程诊断包,现场运维不抓瞎。

安装与运行前,你可能想知道

必须要 GPU 吗?

不需要。CPU 即可运行推理与 PatchCore 建库;有 NVIDIA 显卡时训练明显更快。GPU 训练另装 CUDA 版 PyTorch 即可,平台自动识别。

最小化安装?

pip install byoe-vision 只装核心;[anomaly] / [yolo] / [server] / [mqtt] 等可选 extras 按需组合,[all] 一步到位。

商业使用要收费吗?

MIT 协议,完全免费。可以打包成你的产品的一部分交付给客户,无需授权费用。

支持哪些输入源?

图像文件、文件夹监控、屏幕捕获、摄像头 / RTSP(CLI 输入源 camera://rtsp://screen://)。

样本要多少张?

异常检测建议 100~300 张正常品;只需正常样本,不需要缺陷标注。YOLO 任务按类别各几十张起。

没有例程时怎么开始?

画布旁的 AI 助手可以直接帮你搭:用一句话描述检测需求,它查节点手册、搭线、校验、试跑。也可以用任意 MCP 客户端远程驱动。

今天就给产线装上慧眼

开源免费,无节点数限制,无授权费用

查看快速上手
pip install byoe-vision[all]