lingshu-sdk 0.10.0

Lingshu SDK — build autonomous AI agents in Rust
docs.rs failed to build lingshu-sdk-0.10.0
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

Lingshu Rust SDK

WHY

This crate gives Rust applications direct access to the Lingshu agent runtime without going through a CLI or external bridge.

Use it when you want:

  • a strongly typed builder API
  • direct control over tools, memory, and sessions
  • first-class async Rust ergonomics
  • repeatable local Ollama validation before production rollout

WHAT

The Rust SDK includes:

  • SdkAgent for chat, run, stream, batch, and fork workflows
  • SdkConfig for profile-aware configuration
  • SdkSession and MemoryManager for persistence
  • SdkToolRegistry for custom tools
  • runnable examples in examples/README.md

Start here if you want business value fast

Goal Best example
Show a practical operations copilot business_case_showcase.rs
Review work without overspending cost_aware_review.rs
Build a support assistant with memory session_aware_support.rs
Validate the core SDK surface locally e2e_smoke.rs

Verified proof status

The SDK examples are backed by fresh local Ollama verification across all targets:

Target Proof result
Rust 34/34 passed
Node.js 30/30 passed
Python 28/28 passed
WASM 17/17 passed

Architecture

Rust application
      |
      v
  SdkAgent builder
      |
      +--> config
      +--> tools
      +--> sessions
      +--> memory
      |
      v
Agent runtime and provider calls

HOW

Quick start

cargo run --example basic_usage -p lingshu-sdk
cargo run --example business_case_showcase -p lingshu-sdk

Local proof with Ollama

cd crates/lingshu-sdk
make e2e

Examples

The full example guide lives in examples/README.md.