nndeploy

一套代码搞定多端AI推理,省心又高效

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 230 🐛 待处理 23 👀 关注 34
GitHub ↗
GitHub 星标 ★ 1897
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源框架,Apache-2.0许可证,完全免费,无付费版本。

项目预览

nndeploy 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开源模型
开发团队nndeploy
定价模式🏷️完全免费
价格说明开源框架,Apache-2.0许可证,完全免费,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言C++
技术栈/模型ai,ascend,deep-learning,deployment,diffusers,genai,llm,low-code,low-code-platform,mnn,no-code,onnxruntime,openvino,python,pytorch,tensorrt,transformer,workflow
GitHub 星标★ 1897
上线时间2023-08-08 00:00:00
代码更新2026-08-15
仓库体积76.5 MB
本站数据更新2026-11-08
维护状态维护中
收录时间2026-08-09
浏览次数4

项目介绍

nndeploy 是一款专注于 AI 模型部署的 C++ 框架,旨在解决深度学习模型从训练到生产环境落地时面临的碎片化问题。它提供统一的推理接口,屏蔽了不同后端(如 TensorRT、ONNX Runtime、OpenVINO 等)的差异,让开发者只需编写一次代码即可在不同硬件上运行。核心能力包括多端推理、模型转换、性能优化和动态图支持,强调易用性与高性能的平衡。通过模块化设计,用户可灵活组合预处理、推理和后处理流程,降低部署复杂度。项目处于成长阶段,文档和示例逐步完善,适合需要快速集成多硬件推理的团队。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1897

使用教程

难度:入门 约 10 分钟 部署方式:库/依赖 7 步

环境要求

  • Python 3.10 或更高版本
  • 可用的 pip 包管理环境
  • 浏览器,用于访问可视化工作流编辑器
  • 更多推理后端(超出默认的 ONNXRuntime、MNN)需采用开发者模式

安装与启动步骤

  1. 1安装 nndeploy

    使用 pip 升级安装 nndeploy,默认包含 ONNXRuntime 与 MNN 推理后端。

    pip install --upgrade nndeploy
  2. 2启动可视化界面

    用命令行方式启动工作流编辑器,并指定监听端口为 8000。

    nndeploy-app --port 8000
  3. 3代码方式启动(可选)

    若不使用命令行方式,可进入 nndeploy 目录用 app.py 启动,端口同样为 8000。

    cd path/to/nndeploy
    python app.py --port 8000
  4. 4打开工作流编辑器

    启动成功后浏览器访问本地 8000 端口,可拖拽节点、调参并实时预览。

  5. 5保存工作流 JSON

    在界面中搭建调试完成后点击保存,工作流会导出为 JSON 文件。

  6. 6命令行运行工作流

    生产环境中可用 Python CLI 加载 JSON 工作流运行,C++ 版命令为 nndeploy_demo_run_json。

    nndeploy-run-json --json_file path/to/workflow.json
  7. 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否可视化界面监听端口,示例为 80008000
--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···

★ 58 2026-08-09
llmedge 开源

在 Android 上轻松跑多模态 AI,离线推理一条龙

Android native AI inference library, bringing text, image, video, STT, TTS inference

★ 73 2026-08-09
ComfyUI-Distributed 开源

多张显卡一起跑 ComfyUI,出图更快

ComfyUI extension that enables multi-GPU processing locally, remotely and in the clo···

★ 649 2026-10-30
prompt-cache 开源

给 LLM 加个缓存,成本直降 80%,响应快到飞起

Cut LLM costs by up to 80% and unlock sub-millisecond responses with intelligent sem···

★ 426 2026-08-09
Minimalistic-Comfy-Wrapper-WebUI 开源

给 ComfyUI 加个轻量推理面板,预设+队列,省心批量出图出音频

MCWW: Additional non-node based UI for ComfyUI focused on inference. Stable UI state···

★ 145 2026-08-09
Containarium 开源

给 AI 代理套上安全隔离壳,放心执行任意代码

Open-source agent runtime — SSH-native isolation, eBPF egress policy, Kubernetes + ···

★ 317 2026-08-09