luminal

Rust 写的轻量推理引擎,模型跑得更快更省

开源 🏷️定价信息待确认 ⏳ 访问状态待核验 基础设施 🍴 复刻 254 🐛 待处理 73 👀 关注 21
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 3045
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

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

项目数据

分类基础设施
开发团队luminal-ai
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态⏳ 访问状态待核验
是否开源是
开源协议Apache-2.0
主要语言Rust
GitHub 星标★ 3045
上线时间2023-07-18 00:00:00
代码更新2026-11-07
仓库体积105.4 MB
本站数据更新2026-11-08
维护状态活跃
收录时间2026-11-08
浏览次数0

项目介绍

Luminal 是一个用 Rust 编写的轻量级深度学习推理框架,目标是让模型推理跑得更快、更省资源。它解决的是传统推理栈依赖多、启动慢、在 CPU 和 GPU 上难以兼顾性能的问题。核心能力包括:基于 Rust 的高性能执行引擎,支持将训练好的模型编译为高效计算图并做算子融合与内存复用;提供简洁的 Python 前端用于定义和加载模型,底层由 Rust 负责调度;支持 CPU 与 GPU 后端,并针对小批量、低延迟场景做优化。项目强调「编译式推理」思路,把模型图静态优化后再执行,减少运行时开销。适合需要嵌入到服务端、边缘设备或对启动时间和内存占用敏感的应用。当前星标约 3000,处于成长阶段,API 和生态仍在快速迭代中。

Star 增长趋势

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

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

使用教程

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

难度:进阶 约 30 分钟 部署方式:库/依赖 5 步

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

环境要求

  • Rust 工具链(含 cargo,能执行 cargo run)
  • Git,用于克隆仓库
  • 运行 Llama 3 8B 示例需要 CUDA 环境(示例使用 luminal_cuda_lite 与 device 特性)

安装与启动步骤

  1. 1获取源码

    把 Luminal 仓库克隆到本地;README 未提供包管理器安装命令,示例均在仓库内运行。

    git clone https://github.com/luminal-ai/luminal.git
  2. 2进入项目目录

    进入仓库根目录执行后续命令,cargo 的 -p 参数依赖 workspace 结构。

    cd luminal
  3. 3确认 Rust 环境

    先确认 cargo 可用;跑 GPU 示例还需机器上有可用的 CUDA 环境。

    cargo --version
  4. 4运行 Llama3 示例

    编译并运行仓库自带的 Llama 3 8B CUDA 示例,首次编译耗时较长。

    cargo run --release -p luminal_cuda_lite --example llama3 --features device
  5. 5参考最小用法

    README 的 Rust 示例流程:建图→matmul→compile→set_data→execute→get_f32 取结果。

关键配置

配置项必填说明示例
features是运行 CUDA 示例时需要启用的 cargo 特性device
Runtime是执行后端,README 示例使用参考运行时ReferenceRuntime::default()
CompileOptions否编译计算图时的选项参数CompileOptions::default()
DType否张量数据类型,示例使用 F32DType::F32

如何确认成功

示例运行结束且终端打印出 Result 结果,即表示推理链路正常。

常见问题

Q:没有 GPU 可以跑吗?

A:README 的 Llama3 示例基于 luminal_cuda_lite 与 device 特性,需要 CUDA 环境;纯 CPU 只给出了 ReferenceRuntime 的建图示例。

Q:在 PyTorch 里怎么接入?

A:README 说明可作为编译后端使用 torch.compile(model, backend=luminal_cuda),但未给出 Python 包的安装命令,需自行参考仓库。

Q:报错找不到 luminal_cuda_lite 包?

A:该包是仓库 workspace 内的成员,必须在仓库根目录执行带 -p 参数的命令,不要在其他目录运行。

Q:为什么建议加 --release?

A:README 的示例命令使用 --release 构建,推理与编译场景下优化构建才能体现性能。

注意事项

  • README 未提供 crate 安装或 pip 安装说明,所有示例都以仓库内源码方式运行。
  • Llama 3 8B 示例需要模型权重,README 未说明权重获取与放置路径,运行前需自行确认。
  • 自行编写 Rust 代码时需引入 luminal::prelude::* 才能使用 Graph、DType 等类型。

核心亮点

  • Rust 实现,无 GC 和重运行时依赖,启动快、内存占用低
  • 采用编译式图优化,做算子融合与静态内存规划,降低推理开销
  • Python 前端定义模型、Rust 后端执行,兼顾易用性与性能

不足之处

  • 生态较新,支持的算子与模型格式覆盖有限,复杂模型可能需自行扩展
  • 文档和社区规模仍在成长,遇到问题可参考的案例较少

适用场景

  • 服务端低延迟模型推理部署
  • 边缘设备或嵌入式环境运行轻量模型
  • 对启动时间和内存占用敏感的在线推理服务

替代项目

ONNX Runtime、TVM、tract

上一篇:ds4

下一篇:gemma.cpp

同类项目推荐

k8ssandra-operator 开源

在 K8s 上像管理应用一样管理 Cassandra 集群,自动部署与运维

The Kubernetes operator for K8ssandra

★ 243 2026-08-09
terraform-aws-metaflow 开源

用 Terraform 在 AWS 上快速搭建生产级 Metaflow 环境

Deploy production-grade Metaflow cloud infrastructure on AWS

★ 70 2026-08-09
Reach 开源

一个开源应用搞定 SSH、SFTP、隧道和自动化运维

A modern, cross-platform SSH client and remote server management tool. Tabbed termin···

★ 128 2026-10-22
MLOpsTemplate 开源

一键搭建标准化MLOps流水线,快速落地生产

Providing tools and templates to facilitate modern MLOps practices

★ 90 2026-08-09
traccia-py 开源

给 AI Agent 装上黑匣子,追踪、评估、治理一步到位

OpenTelemetry-native SDK for AI agent observability, tracing, evaluation, debugging,···

★ 133 2026-10-07
llmdocparser 开源

用大模型读懂PDF,自动提取关键信息,告别手动整理

A package for parsing PDFs and analyzing their content using LLMs.

★ 266 2026-08-09
u-claw 开源

插上U盘,离线一键装好AI编程助手

U-Claw 虾盘 — OpenClaw AI 助手离线安装 U 盘:一键装好 Claude Code/Codex/OpenClaw,无···

★ 1756 2026-08-09
GPTCache 开源

给 LLM 加个语义缓存,重复问题秒回,省钱又提速

Semantic cache for LLMs. Fully integrated with LangChain and llama_index.

★ 8221 2026-08-09
polyaxon 开源

一站式管理AI实验、训练与部署,让团队协作更高效。

AI Infra / AI Orchestration / AI Control Plane

★ 3747 2026-08-09