Back to Mistral Rs

Enable PagedAttention for efficient KV-cache memory management

docs/src/content/docs/examples/rust/advanced/paged-attn.md

0.8.131.7 KB
Original Source
<!-- generated by docs/scripts/render_examples.py; edit the source example instead -->

Enable PagedAttention for efficient KV-cache memory management.

Run with: cargo run --release --example paged_attn -p mistralrs

rust
//! Enable PagedAttention for efficient KV-cache memory management.
//!
//! Run with: `cargo run --release --example paged_attn -p mistralrs`

use anyhow::Result;
use mistralrs::{
    IsqBits, MemoryGpuConfig, ModelBuilder, PagedAttentionMetaBuilder, TextMessageRole,
    TextMessages,
};

#[tokio::main]
async fn main() -> Result<()> {
    let model = ModelBuilder::new("Qwen/Qwen3-4B")
        .with_auto_isq(IsqBits::Eight)
        .with_logging()
        .with_paged_attn(
            PagedAttentionMetaBuilder::default()
                .with_block_size(32)
                .with_gpu_memory(MemoryGpuConfig::ContextSize(1024))
                .build()?,
        )
        .build()
        .await?;

    let messages = TextMessages::new()
        .add_message(
            TextMessageRole::System,
            "You are an AI agent with a specialty in programming.",
        )
        .add_message(
            TextMessageRole::User,
            "Hello! How are you? Please write generic binary search function in Rust.",
        );

    let response = model.send_chat_request(messages).await?;

    println!("{}", response.choices[0].message.content.as_ref().unwrap());
    dbg!(
        response.usage.avg_prompt_tok_per_sec,
        response.usage.avg_compl_tok_per_sec
    );

    Ok(())
}

Source: mistralrs/examples/advanced/paged_attn/main.rs