信任每一次
完整运行。

面向 Rust 的类型安全、可观测、可取消、预算感知运行时，统一承载模型、工具、Agent 与工作流。

quickstart.rs● READY

use runifold::ProviderModelExt;
use runifold_providers::openai::OpenAiClient;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let runtime = OpenAiClient::from_api_key(
        std::env::var("OPENAI_API_KEY")?
    )?.runtime("gpt-5")?;

    let answer = runtime
        .agent("assistant")
        .system("Answer precisely. Expose uncertainty.")
        .prompt_text("Why is durable execution useful?")
        .await?;

    println!("{answer}");
    Ok(())
}

run_01Jopenai:gpt-51.42scompleted

执行内核

表层简单，
底层明确。

从一次 Prompt 开始。系统进入生产阶段后，可以逐步加入约束，而不必替换最初使用的抽象。

每次执行都是一个 Run

稳定的身份与父子因果关系，让整棵执行树可以被完整重建。

权限始终保持显式

工具、检索器和子 Agent 只获得明确授予的能力，不存在环境中的隐式权限继承。

失败也有明确语义

取消、截止时间、预算、副作用与不确定重试都属于运行时状态，而不是应用中的口头约定。

你的第一次运行

从空项目
到得到答案。

安装稳定的运行时与一个明确的 Provider Adapter，并让厂商细节始终停留在系统边缘。

完成经过编译验证的 Quickstart →

终端zsh

cargo add runifold@0.9.0
cargo add runifold-providers@0.9.0 --features openai
cargo add tokio --features macros,rt-multi-thread

$ 一个稳定运行时、一个显式 Provider Adapter，没有隐藏执行。

探索完整平台

01 / 执行内核

控制每一次 Run

身份、预算、取消、Capability 与 Journal。

02 / 模型与服务商

掌握模型边界

无损内容、规范流、路由与 Provider Runtime。

03 / 持久工作流

跨越进程丢失

Checkpoint、Worker、Lease、Signal、Timer 与租户预算。

信任每一次完整运行。

表层简单，底层明确。