Llama Runner

A straightforward Rust library for running llama.cpp models locally on device.

Example

// Download and run Gemma3 1B QAT
let runner = Gemma3TextRunner::default().await.unwrap();
let answer = runner
    .get_lm_response(TextLmRequest {
        messages: vec![(
            MessageRole::User,
            "What is the capital of France?".to_string(),
        )],
        ..Default::default()
    })
    .unwrap();
assert!(answer.contains("Paris"));

// Download and run Qwen 3.5 4B QAT
// Note that `Gemma3VisionRunner` merely means it's capable
// of running Gemma3 vision models, not necessarily Gemma though
// Configurable using the ::new constructor
let runner = Gemma3VisionRunner::default().await.unwrap();
let answer = runner
    .get_vlm_response(VisionLmRequest {
        messages: vec![
            (
                MessageRole::User,
                ImageOrText::Text("Which city is this building in?".into()),
            ),
            (
                MessageRole::User,
                ImageOrText::Image(
                    image::load_from_memory(include_bytes!("../assets/eiffel-tower.jpg"))
                        .unwrap(),
                ),
            ),
        ],
        prefill: Some("<think>\n".into()), // Thinking mode is disabled by default
        ..Default::default()
    })
    .unwrap();
assert!(answer.contains("Paris"));

Credits

• llama-cpp-rs: this library is bascially a higher level wrapper around it