Skip to content

rust-developer-quickstart.md

Latest commit

 

History

History
57 lines (40 loc) · 1.69 KB

rust-developer-quickstart.md

File metadata and controls

57 lines (40 loc) · 1.69 KB

Rust Developer Quickstart

This is the fastest path to try KelvinClaw from a fresh clone. For beginner and WASM-author paths, see docs/GETTING_STARTED.md.

1) Run Kelvin in one command

kelvin plugin install kelvin.cli
cargo run -p kelvin-host -- --prompt "hello kelvin" --memory fallback

Expected output includes:

  • cli plugin preflight (kelvin_cli executed ...)
  • run accepted
  • lifecycle events (start / end)
  • assistant payload (echo provider for MVP)

2) Validate security/stability suites

SDK suites:

cargo test -p kelvin-sdk
scripts/test-plugin-author-kit.sh
scripts/test-docker.sh

Before final pushes:

scripts/test-docker.sh --final

If you need to reclaim disk from the shared Docker caches, remove ./.cache/docker.

Memory controller OWASP + NIST suites:

cargo test -p kelvin-memory-controller --test memory_controller_owasp_top10_ai_2025
cargo test -p kelvin-memory-controller --test memory_controller_nist_ai_rmf_1_0

3) Current MVP behavior

  • The default demo path uses the built-in echo model provider.
  • CLI flow is SDK-first and runs through a WASM plugin (kelvin_cli) before run execution.
  • Kelvin Core ships first-party SDK tool-pack plugins (fs_safe_read, fs_safe_write, web_fetch_safe, schedule_cron, session_tools).
  • Memory/data-plane split exists and is tested.
  • Plugin install path is prebuilt-package based (no recompiling root required).

For architecture details, see: