
onnxruntime-inference-examples
官方示例照着跑,模型推理快速落地
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-25 · 当前星标 ★ 1701
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- 已安装 Git,可从 GitHub 克隆仓库
- C/C++ 示例对应 Linux 或 Windows 环境(README 提供两平台 CI 徽章)
- JavaScript 示例需要能运行 JS 的环境(README 未给版本)
- 移动端示例需要对应的移动应用开发环境
安装与启动步骤
-
1克隆示例仓库
将官方示例集合下载到本地,后续所有操作都在该目录内进行。
git clone https://github.com/microsoft/onnxruntime-inference-examples.git -
2进入仓库目录
切换工作目录到仓库根目录,便于查看各示例子目录。
cd onnxruntime-inference-examples -
3查看示例列表
README 表格列出 c_cxx、mobile、js、quantization 四类示例,先确定要跑哪一类。
ls -la -
4选择并进入示例目录
按需求进入对应子目录,如只看 C/C++ 推理示例就进入 c_cxx。
cd c_cxx -
5阅读示例内说明
各示例目录内附有自己的说明文件,编译命令、参数和模型获取方式以该说明为准。
ls -la -
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
下一篇:tpu-inference
同类项目推荐
tensorzero
开源
大模型上线后的监控调优全包办,出问题不再抓瞎
TensorZero is an open-source LLMOps platform that unifies an LLM gateway, observabil···
lemonade
开源
一键在本地 GPU/NPU 上跑优化大模型,数据不出门
Lemonade helps users discover and run local AI apps by serving optimized LLMs right ···
aisix
开源
用 Rust 打造的统一 AI 网关,一套 API 接入所有主流大模型。
Open-source AI gateway for LLMs & AI agents, built in Rust. One OpenAI-compatible AP···
toshllm
开源
让 Intel Mac 的 AMD 显卡也能本地跑大模型
Run large language models locally on Intel Macs with AMD GPUs - native macOS app wit···
cli
开源
用代码图谱给 AI 编程省 token,只喂相关代码,不烧钱。
Save 40%+ on agent token costs with code graphs: call graphs, dependency graphs, dea···
data-science-best-practices
开源
把数据科学项目从原型打磨成生产级系统
The goal of this repository is to enable data scientists and ML engineers to develop···
easy-vecdb
开源
手把手带你从零实现向量数据库,搞懂原理不再黑盒
从零开始的向量数据库原理与实践教程,在线阅读地址:https://easy-vecdb.datawhale.cc/
kserve
开源
在 Kubernetes 上标准化部署 AI 模型,一键搞定推理服务
Standardized Distributed Generative and Predictive AI Inference Platform for Scalabl···
PowerInfer
开源
让普通电脑也能飞快跑大模型,省显存不减速
High-speed Large Language Model Serving for Local Deployment