Juncture

Typed state machine framework for building LLM agent applications in Rust. Juncture is a Rust implementation of LangGraph, providing the same programming model with Rust's type safety and performance.

Features

• Typed State Machine: Compile-time state validation with #[derive(State)]
• Pregel Execution Engine: Multi-core parallel execution with bounded concurrency
• Checkpoint Persistence: Save/restore execution state for time-travel debugging and crash recovery
• HITL Workflows: Human-in-the-loop interrupts with interrupt!() macro
• LLM Providers: Built-in support for Anthropic, OpenAI, and Ollama
• Tool Infrastructure: Tool trait, ToolNode, interceptors, and transformers
• Prebuilt Agents: ReAct agent pattern, MessagesState, agent factory with middleware
• Observability: OpenTelemetry integration and Langfuse-compatible telemetry

Quick Start

use juncture::prelude::*;
use juncture::prebuilt::{create_react_agent, MessagesState};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Create a simple ReAct agent
    let agent = create_react_agent::<MessagesState>(
        ChatAnthropic::new("claude-3-5-sonnet-20241022")?,
        vec![/* your tools */],
    );

    // Run the agent
    let result = agent.invoke(MessagesState::new("Hello!")).await?;
    println!("Response: {:?}", result.messages.last());
    Ok(())
}

Feature Flags

Examples

See the examples directory for complete working examples.

License

Licensed under Apache License, Version 2.0. See LICENSE for details.