hippmem-engine 0.1.0

HIPPMEM native association memory engine — unified public Rust API orchestration layer
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

//! HIPPMEM quick-start example.
//!
//! Run: cargo run --example basic_usage --features api-backends
//! (without an API key: cargo run --example basic_usage, uses the degraded backend)

use hippmem_core::model::enums::ContentType;
use hippmem_core::model::unit::WriteContext;
use hippmem_engine::{Engine, EngineConfig, RetrieveContext, RetrieveInput, WriteMemoryInput};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Use a temporary directory for storage
    let dir = tempfile::tempdir()?;
    let config = EngineConfig {
        store_dir: dir.path().join("hippmem.redb"),
        ..Default::default()
    };
    let engine = Engine::open(config)?;

    // Write a memory
    let out = engine.write(WriteMemoryInput {
        content: "The user prefers Rust for development and redb for embedded storage.".into(),
        content_type: Some(ContentType::Preference),
        context: WriteContext {
            conversation_id: Some(1),
            session_id: Some(1),
            ..ctx_default()
        },
        importance_hint: Some(0.8),
        source_refs: vec![],
    })?;
    println!("write succeeded: memory_id={}", out.memory_id.0);

    // Retrieve memories
    let results = engine.retrieve(RetrieveInput {
        query: "What language and database does the user prefer?".into(),
        context: RetrieveContext::default(),
        top_k: 3,
        max_hops: None,
        retrieval_mode: hippmem_core::model::links::RetrievalMode::Balanced,
    })?;

    for r in &results.results {
        println!(
            "[{:.3}] {} (dims: {:?})",
            r.final_score,
            r.memory.content.raw.chars().take(50).collect::<String>(),
            r.matched_dimensions
        );
    }

    engine.close()?;
    Ok(())
}

fn ctx_default() -> WriteContext {
    WriteContext {
        conversation_id: None,
        session_id: None,
        project_id: None,
        task_id: None,
        user_id: None,
        local_time: hippmem_core::time::Timestamp(0),
        preceding_memory_ids: vec![],
        source_refs: vec![],
    }
}