aimem-core 0.3.9

Core library for AiMem — give your AI a memory. Hybrid search + knowledge graph over Turso.
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

//! # aimem-core
//!
//! **Give your AI a memory — reusable core library.**
//!
//! `aimem-core` is a pure-Rust library that stores, retrieves, and searches
//! text memories using [Turso](https://github.com/tursodatabase/turso) (an in-process
//! SQLite engine with native vector support) as the sole storage backend.
//!
//! ## Feature overview
//!
//! | Feature | Implementation |
//! |---------|---------------|
//! | Vector storage | Turso `vector32()` BLOB column |
//! | Semantic search | `vector_distance_cos()` — SimSIMD-accelerated cosine |
//! | Full-text search | Turso FTS / Tantivy (`fts_match`, `fts_score`) |
//! | Embedding generation | Gemini 2.0 (Remote) or `fastembed` (Local) |
//! | Knowledge graph | Temporal entity-relationship triples in SQLite |
//! | Graph traversal | BFS over wing/room adjacency — no graph DB needed |
//!
//! ## Architecture: 4-Layer Memory Stack
//!
//! ```text
//! ┌─────────────────────────────────────────────────────────┐
//! │  L0  Identity text           ~100 tokens   always loaded │
//! │  L1  Essential story         ~500-800 tok  always loaded │
//! │  L2  On-demand recall        ~200-500 tok  loaded on ask │
//! │  L3  Deep hybrid search      unlimited     full memory   │
//! └─────────────────────────────────────────────────────────┘
//! ```

pub mod config;
pub mod convo;
pub mod db;
pub mod embedder;
pub mod extractor;
pub mod graph;
pub mod knowledge;
pub mod layers;
pub mod miner;
pub mod search;
pub mod types;

pub use config::Config;
pub use convo::{ConvoMineStats, ConvoMiner};
pub use db::{AimemDb, EmbeddingStoreProfile};
pub use embedder::{Embedder, Gemini2Embedder, LocalEmbedder};
pub use graph::{AimemGraph, TraversalNode};
pub use knowledge::KnowledgeGraph;
pub use layers::MemoryStack;
pub use miner::Miner;
pub use search::Searcher;
pub use types::{
    ContentPart, Drawer, DrawerFilingRequest, DrawerMeta, Entity, HybridSearchResult,
    KeywordSearchResult, RoomNode, SearchResult, Triple, Tunnel,
};

/// Curated high-level imports for typical AiMem integrations.
pub mod prelude {
    pub use crate::{
        AimemDb, AimemGraph, Config, ContentPart, ConvoMineStats, ConvoMiner, Drawer,
        DrawerFilingRequest, DrawerMeta, Embedder, EmbeddingStoreProfile, Entity, Gemini2Embedder,
        HybridSearchResult, KeywordSearchResult, KnowledgeGraph, LocalEmbedder, MemoryStack, Miner,
        RoomNode, SearchResult, Searcher, Triple, Tunnel,
    };
}