uzu

环境要求

• Rust 工具链与 Cargo（使用 Rust 绑定时）
• Python 环境 + uv 包管理器（使用 Python 绑定时）
• Node.js 环境 + pnpm（使用 TypeScript 绑定时）
• Swift 工具链与 SPM（使用 Swift 绑定时）
• 可正常访问 GitHub 与模型下载源的网络

安装与启动步骤

1. 1选择语言绑定

   README 提供 Rust、Python、Swift、TypeScript 四种绑定，按你的项目技术栈选一种即可，绑定版本均为 0.5.26。

2. 2安装 Python 依赖

   在项目中使用 uv 添加 uzu 包，README 指定版本 0.5.26，避免与示例 API 不一致。

   uv add uzu==0.5.26

   复制

3. 3安装 TypeScript 依赖

   使用 pnpm 添加官方 npm 包 @trymirai/uzu，版本锁定 0.5.26，与 README 示例对应。

   pnpm add @trymirai/uzu@0.5.26

   复制

4. 4添加 Rust 依赖

   在 Cargo.toml 的 [dependencies] 中写入 README 给出的 git 依赖，分支为 main，包名为 uzu。

   [dependencies]
   uzu = { git = "https://github.com/trymirai/uzu", branch = "main", package = "uzu" }

   复制

5. 5添加 Swift 依赖

   在 Package.swift 的 dependencies 数组中声明 uzu 包，版本从 0.5.26 起，随后 import Uzu。

   dependencies: [
       .package(url: "https://github.com/trymirai/uzu.git", from: "0.5.26")
   ]

   复制

6. 6运行示例代码

   把 README 中对应语言的 Quick Start 代码复制到 main 文件后运行；模型会自动下载并输出进度。

关键配置

如何确认成功

运行示例后终端先输出下载进度到 100%，随后打印 Reasoning 与 Text 即表示推理成功。

常见问题

注意事项

• Python、TypeScript、Swift 绑定版本均对齐 0.5.26，混用版本可能导致 API 不一致。
• 示例代码均为异步风格，需用对应语言的 async 运行时入口执行。
• 首次运行需要下载模型权重，耗时取决于网络状况。
• 项目基于 MIT 许可证发布，详细推理配置见官方文档 docs.trymirai.com。