#tensor #deep-learning #machine-learning

rai-derive

Rust中的ML框架,具有便利的API

4个版本 (重大变更)

0.11.0 2024年5月14日
0.10.0 2024年3月26日
0.9.0 2024年2月24日
0.8.0 2024年2月20日

#125 in #tensor

每月26次下载
4 个crate中使用(直接使用2个)

MIT/Apache

14KB
200 代码行

RAI

Rust Docs Status Latest Version Discord

Rust中的ML框架,具有便利的API。类似JAX的惰性计算和可组合变换。

安装

cargo add rai

代码片段

函数变换(jvp、vjp、grad、value_and_grad)

use rai::{grad, Cpu, Tensor, F32};

fn f(x: &Tensor) -> Tensor {
    x.sin()
}

fn main() {
    let grad_fn = grad(grad(f));
    let x = &Tensor::ones([1], F32, &Cpu);
    let grad = grad_fn(x);
    println!("{}", grad.dot_graph());
    println!("{}", grad);
}

NN模块、优化器和损失函数

fn loss_fn<M: TrainableModule<Input = Tensor, Output = Tensor>>(
    model: &M,
    input: &Tensor,
    labels: &Tensor,
) -> (Tensor, Aux<Tensor>) {
    let logits = model.forward(input);
    let loss = softmax_cross_entropy(&logits, labels).mean(..);
    (loss, Aux(logits))
}

fn train_step<M: TrainableModule<Input = Tensor, Output = Tensor>, O: Optimizer>(
    optimizer: &mut O,
    model: &M,
    input: &Tensor,
    labels: &Tensor,
) {
    let vg_fn = value_and_grad(loss_fn);
    let ((_loss, Aux(_logits)), (grads, ..)) = vg_fn((model, input, labels));
    let mut params = optimizer.step(&grads);
    eval(&params);
    model.update_params(&mut params);
}

示例

  • 线性回归
    • cargorun --bin线性回归 --release
  • mnist
    • cargorun --binmnist --release
    • cargorun --binmnist --release --功能=cuda
  • mnist-cnn
    • cargorun --binmnist-cnn --release
    • cargorun --binmnist-cnn --release --功能=cuda
  • phi2
    • cargorun --binphi2 --release
    • cargorun --binphi2 --release --功能=cuda
  • phi3
    • cargorun --binphi3 --release
    • cargorun --binphi3 --release --功能=cuda
  • qwen2
    • cargorun --binqwen2 --release
    • cargorun --binqwen2 --release --功能=cuda
  • gemma
    • http://hugging-face.cn/google/gemma-2b中接受许可协议
    • pip install huggingface_hub
    • 登录hf huggingface-cli login
    • cargorun --bingemma --release
    • cargorun --bingemma --release --功能=cuda
  • vit
    • cargorun --binvit --release
    • cargorun --binvit --release --功能=cuda

许可协议

该项目受以下任一协议许可:

任选其一。

依赖项

~3.5MB
~65K SLoC