项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 2551
使用教程
环境要求
- Python 环境(wheel 会嵌入 DeepDetect 运行时到当前环境)
- 可访问 https://www.deepdetect.com/download/wheels/simple 额外索引源
- 使用 GPU 版需具备 CUDA 环境
- 如需训练过程可视化,需安装 visdom
安装与启动步骤
-
1安装 CPU 版 wheel
在当前 Python 环境安装 deepdetect-cpu,装好后可用 import deepdetect 和 deepdetect 命令。cpu 与 gpu 包互斥,只能装一个。
python -m pip install --extra-index-url https://www.deepdetect.com/download/wheels/simple deepdetect-cpu -
2或安装 GPU 版
CUDA 环境请改装 deepdetect-gpu 包,后续 train / infer 命令再加 --gpu 即可走显卡。
python -m pip install --extra-index-url https://www.deepdetect.com/download/wheels/simple deepdetect-gpu -
3查看可用配置
列出内置 CLI profiles 与各命令帮助,确认 yolox、segformer 等 profile 已随 wheel 一起安装。
deepdetect inspect models deepdetect train yolox --help deepdetect infer segformer --help -
4启动可视化服务
另开一个终端安装并启动 Visdom,训练时用 --terminal live 把进度显示在 8097 端口网页上。
python -m pip install visdom python -m visdom.server -port 8097 -
5准备快速开始数据
用仓库自带脚本生成微型 YOLOX 数据集、模型仓库和 quickstart YAML,并打印出 Sample image 路径。
python bindings/python/scripts/prepare_cli_yolox_quickstart.py \ --output /tmp/deepdetect-yolox-quickstart \ --force -
6训练小模型
用上一步生成的 YAML 跑一个很小的 YOLOX 训练;--terminal live 需配合已启动的 Visdom。
deepdetect train yolox \ --config /tmp/deepdetect-yolox-quickstart/yolox-quickstart.yaml \ --terminal live -
7运行推理
把 <sample-image> 换成准备脚本打印的 Sample image 路径,加 --visualize 输出带框的检测结果图。
deepdetect infer yolox <sample-image> \ --config /tmp/deepdetect-yolox-quickstart/yolox-quickstart.yaml \ --visualize \ --output /tmp/deepdetect-yolox-quickstart/detections.png
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--config | 是 | 指定 YAML 配置文件,让训练/推理可重复执行 | /tmp/deepdetect-yolox-quickstart/yolox-quickstart.yaml |
--gpu | 否 | 在 train / infer 命令上启用 CUDA 加速,需装 gpu 版 wheel | --gpu |
--output | 否 | 推理时的结果输出路径 | /tmp/deepdetect-yolox-quickstart/detections.png |
--terminal | 否 | 训练终端输出方式,live 表示接 Visdom 实时可视化 | live |
如何确认成功
运行 deepdetect inspect models 能列出 yolox、segformer 等 profile;推理命令执行后生成 /tmp/deepdetect-yolox-quickstart/detections.png 即成功
常见问题
Q:deepdetect-cpu 和 deepdetect-gpu 能同时装吗?
A:不能。两者都提供 import deepdetect,在同一环境中互斥,只能选其中一个安装。
Q:训练加了 --terminal live 却没画面?
A:需要先在另一个终端执行 python -m pip install visdom,再运行 python -m visdom.server -port 8097 启动服务。
Q:怎么在显卡上跑这个例子?
A:安装 deepdetect-gpu wheel,并在 train 与 infer 命令上都追加 --gpu 参数。
Q:想要常驻的 REST 服务怎么办?
A:wheel/CLI 适合本地训练与推理;长期 REST 服务请看 docs/api.md,容器化服务看 docs/docker.md,自定义 C++ 构建看 docs/source.md。
注意事项
- CLI 自带的 YAML 只是默认示例,正式使用前需替换数据集、权重和模型仓库路径。
- deepdetect-cpu 与 deepdetect-gpu 提供相同的 import 名,同一环境不能共存。
- --gpu 只在使用 GPU 版 wheel 且环境具备 CUDA 时可用。
- 更多训练、推理、监控与配置优先级细节见 bindings/python/deepdetect/cli/CLI_SPEC.md。
核心亮点
- 支持多框架(Caffe、Torch、TensorRT),灵活切换模型
- 提供 RESTful API,易于集成到现有系统
- 内置图像分类、目标检测等常用任务,开箱即用
不足之处
- 文档和社区活跃度一般,学习资源相对有限
- 部分高级功能依赖特定框架,配置复杂度较高
适用场景
- 快速搭建图像分类或目标检测的推理服务
- 在 GPU 服务器上部署多模型并发处理
- 边缘设备上使用 ncnn 进行轻量化推理
替代项目
TensorFlow Serving、TorchServe、ONNX Runtime
同类项目推荐
manuscript-ocr
开源
在笔记本里调参,把手写稿图片变成可编辑文字
stb-tester
开源
用摄像头看屏幕、用红外按遥控,自动跑机顶盒测试
Automated Testing for Set-Top Boxes and Smart TVs
Weighted-Boxes-Fusion
开源
多模型检测结果融合,提升目标检测精度
Set of methods to ensemble boxes from different object detection models, including i···
zotero-ocr
开源
在 Zotero 里直接给扫描 PDF 做 OCR,文字可搜可引。
Zotero Plugin for OCR
gca
开源
用元胞自动机生成复杂3D结构和纹理,复现ICLR论文
Official implementation of Generative Cellular Automata: ICLR 2021, 2022 (spotlight)
local-llm-pdf-ocr
开源
本地跑视觉大模型,扫描 PDF 秒变可搜索文本
Convert scanned PDFs and images into searchable documents with any OpenAI-compatible···
JiaJiaOCR
开源
Java 一站式 OCR,印刷手写表格都能认
Building on the existing general text recognition capabilities, new features such as···
caption_ocr_tool
开源
把视频里烧死的字幕,一键抠成可编辑文字
视频硬字幕提取工具
Awesome-CV-MasterHub
开源
按图索骥,一篇列表搞定 CV 前沿论文追踪
:fire: :fire: :fire: A paper list of some recent Computer Vision(CV) works
