
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1897
使用教程
环境要求
- Python 3.10 或更高版本
- 可用的 pip 包管理环境
- 浏览器,用于访问可视化工作流编辑器
- 更多推理后端(超出默认的 ONNXRuntime、MNN)需采用开发者模式
安装与启动步骤
-
1安装 nndeploy
使用 pip 升级安装 nndeploy,默认包含 ONNXRuntime 与 MNN 推理后端。
pip install --upgrade nndeploy -
2启动可视化界面
用命令行方式启动工作流编辑器,并指定监听端口为 8000。
nndeploy-app --port 8000 -
3代码方式启动(可选)
若不使用命令行方式,可进入 nndeploy 目录用 app.py 启动,端口同样为 8000。
cd path/to/nndeploy python app.py --port 8000 -
4打开工作流编辑器
启动成功后浏览器访问本地 8000 端口,可拖拽节点、调参并实时预览。
-
5保存工作流 JSON
在界面中搭建调试完成后点击保存,工作流会导出为 JSON 文件。
-
6命令行运行工作流
生产环境中可用 Python CLI 加载 JSON 工作流运行,C++ 版命令为 nndeploy_demo_run_json。
nndeploy-run-json --json_file path/to/workflow.json -
7代码中加载运行
也可在 Python 代码中加载 JSON 工作流,适合集成进现有项目,注意替换真实路径。
graph = nndeploy.dag.Graph("") graph.remove_in_out_node() graph.load_file("path/to/llm_workflow.json") graph.init() input = graph.get_input(0) text = nndeploy.tokenizer.TokenizerText() text.texts_ = ["<|im_start|>user\nPlease introduce NBA superstar Michael Jordan<|im_end|>\n<|im_start|>assistant\n"] input.set(text) status = graph.run() output = graph.get_output(0) result = output.get_graph_output() graph.deinit()
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--port | 否 | 可视化界面监听端口,示例为 8000 | 8000 |
--json_file | 是 | 工作流 JSON 文件路径,供命令行运行使用 | path/to/workflow.json |
如何确认成功
启动后浏览器打开 http://localhost:8000,能看到可视化工作流编辑器即表示启动成功。
常见问题
Q:启动后如何访问可视化界面?
A:在浏览器中打开 http://localhost:8000 即可访问工作流编辑器,支持拖拽节点、调整参数和实时预览效果。
Q:默认支持哪些推理后端?
A:pip 安装的默认版本包含 ONNXRuntime 和 MNN;若需要更多推理后端,请采用开发者模式。
Q:保存后的工作流怎么在生产环境运行?
A:可用命令行 nndeploy-run-json --json_file path/to/workflow.json,或 C++ 的 nndeploy_demo_run_json,也可在 Python/C++ 代码中调用 API 加载。
Q:对 Python 版本有什么要求?
A:要求 Python 3.10 及以上版本。
注意事项
- 命令中的 path/to/... 为示例路径,实际使用时请替换为真实文件路径
- 生产环境可直接加载界面导出的 JSON 工作流,无需重新搭建流程
- 更多推理后端需采用开发者模式,默认仅含 ONNXRuntime 与 MNN
核心亮点
- 统一接口封装多后端,切换硬件无需改业务代码
- 内置性能优化策略,推理速度有保障
- 模块化设计,便于定制和扩展部署流程
不足之处
- 项目较新,生态和社区积累尚浅
- 文档和示例不够丰富,上手需摸索
适用场景
- 边缘设备上部署轻量模型(如摄像头检测)
- 云端服务中集成多种推理引擎统一管理
- 快速原型验证,从训练模型到端侧落地
替代项目
OpenMMLab Deploy、MNN、TNN
上一篇:ctransformers
下一篇:tokenspeed
同类项目推荐
byok-relay
开源
前端直连大模型,用户自带密钥,绕过 CORS 限制
Bring your own key (BYOK) relay to enable lightweight frontend-only apps to use LLMs···
llmedge
开源
在 Android 上轻松跑多模态 AI,离线推理一条龙
Android native AI inference library, bringing text, image, video, STT, TTS inference
generative-ai-on-amazon-sagemake···
开源
照着 Notebook 在 SageMaker 上跑通大模型微调与部署
Amazon SageMaker AI collection of examples, code samples and recipes.
awesome-ml-experiment-management
开源
一张清单,搞定ML实验跟踪工具选型
A curated list of awesome open source tools and commercial products for ML Experimen···
ComfyUI-Distributed
开源
多张显卡一起跑 ComfyUI,出图更快
ComfyUI extension that enables multi-GPU processing locally, remotely and in the clo···
prompt-cache
开源
给 LLM 加个缓存,成本直降 80%,响应快到飞起
Cut LLM costs by up to 80% and unlock sub-millisecond responses with intelligent sem···
Minimalistic-Comfy-Wrapper-WebUI
开源
给 ComfyUI 加个轻量推理面板,预设+队列,省心批量出图出音频
MCWW: Additional non-node based UI for ComfyUI focused on inference. Stable UI state···
Containarium
开源
给 AI 代理套上安全隔离壳,放心执行任意代码
Open-source agent runtime — SSH-native isolation, eBPF egress policy, Kubernetes + ···
semantic-conventions-genai
开源
统一生成式 AI 遥测字段,让 LLM 调用可观测