onnxruntime-inference-examples

官方示例照着跑,模型推理快速落地

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 基础设施 🍴 复刻 418 🐛 待处理 186 👀 关注 37
GitHub ↗
GitHub 星标 ★ 1701
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费

项目预览

onnxruntime-inference-examples 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类基础设施
开发团队microsoft
定价模式🏷️完全免费
价格说明开源免费
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言C++
GitHub 星标★ 1701
上线时间2021-04-09 00:00:00
代码更新2026-10-22
仓库体积501.3 MB
本站数据更新2026-10-25
维护状态活跃
收录时间2026-10-25
浏览次数0

项目介绍

这是微软 ONNX Runtime 官方维护的推理示例集合,用 C++ 等多种语言演示如何在不同平台和场景下加载并运行 ONNX 模型。项目解决的是开发者从训练完成到实际部署推理之间的落地问题:ONNX Runtime 本身是跨平台推理引擎,但接口多、配置项杂,新手容易卡在环境搭建和 API 调用上。该仓库按场景组织示例,覆盖 C++、C#、Python、Java 等语言绑定,包含基础推理、移动端与嵌入式部署、量化与图优化、自定义算子、多执行提供器(CPU、CUDA、TensorRT、OpenVINO 等)切换、与 OpenCV 等库配合做图像预处理等典型用法。每个示例通常配有可直接编译运行的代码和说明,帮助开发者快速验证模型、对比不同后端性能,并作为自己项目的起点模板。

Star 增长趋势

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

数据来源:GitHub API 逐日快照 · 收录于 2026-10-25 · 当前星标 ★ 1701

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

难度:进阶 约 20 分钟 部署方式:本地安装 6 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • 已安装 Git,可从 GitHub 克隆仓库
  • C/C++ 示例对应 Linux 或 Windows 环境(README 提供两平台 CI 徽章)
  • JavaScript 示例需要能运行 JS 的环境(README 未给版本)
  • 移动端示例需要对应的移动应用开发环境

安装与启动步骤

  1. 1克隆示例仓库

    将官方示例集合下载到本地,后续所有操作都在该目录内进行。

    git clone https://github.com/microsoft/onnxruntime-inference-examples.git
  2. 2进入仓库目录

    切换工作目录到仓库根目录,便于查看各示例子目录。

    cd onnxruntime-inference-examples
  3. 3查看示例列表

    README 表格列出 c_cxx、mobile、js、quantization 四类示例,先确定要跑哪一类。

    ls -la
  4. 4选择并进入示例目录

    按需求进入对应子目录,如只看 C/C++ 推理示例就进入 c_cxx。

    cd c_cxx
  5. 5阅读示例内说明

    各示例目录内附有自己的说明文件,编译命令、参数和模型获取方式以该说明为准。

    ls -la
  6. 6按说明编译运行

    仓库根目录 README 未给出统一安装或编译命令,需按所选示例目录内的说明执行。

如何确认成功

按所选示例目录内的说明运行程序,能输出推理结果即表示环境与示例配置正确(README 未给统一验证命令)。

常见问题

Q:仓库里有统一的安装或一键运行脚本吗?

A:没有。README 只按示例类型列出目录表格,未提供统一安装脚本,需进入具体示例目录按其自带说明操作。

Q:支持哪些语言和场景?

A:README 表格列出的有 C/C++ 推理、移动端应用、JavaScript API,以及面向 CPU EP 与 TensorRT EP 的量化示例。

Q:想用 GPU 加速从哪里开始?

A:README 的量化示例部分提到 TensorRT EP,可从 quantization 目录开始查看,具体配置以该目录说明为准。

Q:示例需要自带模型文件吗?

A:README 未统一说明模型来源,各示例对模型的要求不同,请以对应示例目录内的说明为准。

注意事项

  • 本仓库是示例集合,本身不是推理引擎,实际推理需配合 ONNX Runtime 使用(README 中链接到 ONNX Runtime 主仓库)。
  • 命令、依赖版本、端口和路径请以所选示例目录内的说明为准,不要跨示例套用。
  • 示例按目录独立组织,环境依赖各不相同,建议一次只配置并运行一个示例。

核心亮点

  • 微软官方维护,示例与 ONNX Runtime 版本同步,API 用法权威可靠
  • 覆盖 C++、C#、Python、Java 等多语言及桌面、移动、嵌入式多平台场景
  • 包含量化、图优化、多执行提供器切换等工程化主题,贴近真实部署需求

不足之处

  • 示例偏碎片化,缺少从零到完整生产项目的系统性教程
  • 部分示例依赖特定硬件或第三方库,环境配置门槛较高

适用场景

  • 开发者首次将训练好的 ONNX 模型部署到 C++ 服务端时参考代码
  • 移动端或嵌入式设备上集成轻量推理能力时查找平台示例
  • 对比 CPU、CUDA、TensorRT 等不同后端推理性能时做基准测试

替代项目

onnxruntime、tensorrtx、openvino

上一篇:Awesome-LLM-Inference

下一篇:tpu-inference

同类项目推荐

tensorzero 开源

大模型上线后的监控调优全包办,出问题不再抓瞎

TensorZero is an open-source LLMOps platform that unifies an LLM gateway, observabil···

★ 11707 2026-08-09
lemonade 开源

一键在本地 GPU/NPU 上跑优化大模型,数据不出门

Lemonade helps users discover and run local AI apps by serving optimized LLMs right ···

★ 5982 2026-08-09
aisix 开源

用 Rust 打造的统一 AI 网关,一套 API 接入所有主流大模型。

Open-source AI gateway for LLMs & AI agents, built in Rust. One OpenAI-compatible AP···

★ 204 2026-08-09
toshllm 开源

让 Intel Mac 的 AMD 显卡也能本地跑大模型

Run large language models locally on Intel Macs with AMD GPUs - native macOS app wit···

★ 222 2026-09-15
cli 开源

用代码图谱给 AI 编程省 token,只喂相关代码,不烧钱。

Save 40%+ on agent token costs with code graphs: call graphs, dependency graphs, dea···

★ 94 2026-08-09
data-science-best-practices 开源

把数据科学项目从原型打磨成生产级系统

The goal of this repository is to enable data scientists and ML engineers to develop···

★ 98 2026-08-09
easy-vecdb 开源

手把手带你从零实现向量数据库,搞懂原理不再黑盒

从零开始的向量数据库原理与实践教程,在线阅读地址:https://easy-vecdb.datawhale.cc/

★ 427 2026-08-09
kserve 开源

在 Kubernetes 上标准化部署 AI 模型,一键搞定推理服务

Standardized Distributed Generative and Predictive AI Inference Platform for Scalabl···

★ 6149 2026-08-09
PowerInfer 开源

让普通电脑也能飞快跑大模型,省显存不减速

High-speed Large Language Model Serving for Local Deployment

★ 9848 2026-08-09