Guided install cockpit · source-bounded recipes

Memory you can install. Proof you can inspect.

Choose the host you already use. The cockpit gives you the published path, the runtime checks that matter, and the boundary the integration does not cross.

Local-first Fail-open Receipt-aware No hidden claims

01 · CHOOSE A HOST

Use the narrowest integration that fits.

Hook-capable hosts can participate in lifecycle events. MCP-and-rules hosts expose explicit tools and guidance without pretending a rules file is a hidden hook.

Permanent guide ↗

02 · GUIDED EXECUTION

Rust library

Start with the deterministic MockEmbedder, prove storage and retrieval locally, then choose a production embedding boundary deliberately.

BEST FITApplication-owned integration

01Direct Rust API02Deterministic fixture03Hybrid retrieval04Typed receipts

STEP 01 / CONNECT

Prepare the environment. Then change it once.

Choose the environment that will actually launch Rust library. The selector never invents an unsupported translation.

Operating system

Shell

Rust 1.75+

The upstream crate contract currently declares Rust 1.75 as its minimum.

Cargo project

A binary or library crate where you own storage, lifecycle, and embedder configuration.

SQLite-compatible runtime

SQLite is authoritative; indexes and vector artifacts remain derived and rebuildable.

Embedder decision

Begin with MockEmbedder. Select a production provider only after the local contract works.

BASH

Add the current published dependencies

Version 0.5.10 is the version documented by the current upstream README and Cargo manifest. The registry snapshot also observes 0.5.11, whose quick-start sample is not asserted here without matching source documentation.

cargo add semantic-memory@0.5.10
cargo add tokio --features macros,rt

RUST

Use a deterministic embedder first

Save as src/main.rs. This fixture needs no hosted model or embedding download.

use semantic_memory::{EmbeddingConfig, MemoryConfig, MemoryStore, MockEmbedder};
use std::path::PathBuf;

#[tokio::main(flavor = "current_thread")]
async fn main() -> Result<(), semantic_memory::MemoryError> {
    let config = MemoryConfig {
        base_dir: PathBuf::from("memory-example"),
        embedding: EmbeddingConfig {
            dimensions: 768,
            ..Default::default()
        },
        ..Default::default()
    };

    let store = MemoryStore::open_with_embedder(
        config,
        Box::new(MockEmbedder::new(768)),
    )?;

    store
        .add_fact("general", "Rust was first released in 2015", None, None)
        .await?;

    let results = store
        .search("when was Rust released", Some(5), Some(&["general"]), None)
        .await?;

    for result in results {
        println!("{:.4} {}", result.score, result.content);
    }

    Ok(())
}

RESOLVING ROUTEFollowing the evidence boundary…

use semantic_memory::{EmbeddingConfig, MemoryConfig, MemoryStore, MockEmbedder}; use std::path::PathBuf; #[tokio::main(flavor = "current_thread")] async fn main() -> Result<(), semantic_memory::MemoryError> { let config = MemoryConfig { base_dir: PathBuf::from("memory-example"), embedding: EmbeddingConfig { dimensions: 768, ..Default::default() }, ..Default::default() }; let store = MemoryStore::open_with_embedder( config, Box::new(MockEmbedder::new(768)), )?; store .add_fact("general", "Rust was first released in 2015", None, None) .await?; let results = store .search("when was Rust released", Some(5), Some(&["general"]), None) .await?; for result in results { println!("{:.4} {}", result.score, result.content); } Ok(()) }