Crate minuet

Crate minuet 

Source
Expand description

§Minuet: A Toolkit for Holographic Memory Systems

“The optical table for holographic computing.”

Minuet is an open-source Rust toolkit that extends amari-holographic with higher-level abstractions for building cognitive memory systems. While amari-holographic provides the core BindingAlgebra trait and algebra implementations, Minuet adds:

  • Memory Stores: Sharded, partitioned, and layered memory configurations
  • Retrieval Strategies: Direct, resonator-based, hybrid pipelines
  • Encoding Infrastructure: Symbol codebooks, composite encoders
  • Capacity Management: Monitoring, eviction policies, consolidation
  • Persistence: Snapshots, journaling, crash recovery
  • Pipeline Composition: Fluent builders for assembling memory systems

Named after Star Trek’s first sentient hologram, Minuet builds on the foundations of amari-holographic to enable application-specific memory architectures.

§Quick Start

use minuet::prelude::*;
use amari_holographic::ProductCliffordAlgebra;

type Algebra = ProductCliffordAlgebra<64>; // 512 dimensions

// Create a simple memory
let memory = SimpleMemory::<Algebra>::new();

// Create symbols from codebook
let key = memory.symbol("paris");
let value = memory.symbol("france");

// Store and retrieve
memory.store(&key, &value)?;
let result = memory.retrieve(&key)?;

§Capacity Model

Holographic memory has capacity O(DIM / log DIM). For typical dimensions:

Algebra TypeDimensionApprox. Capacity
ProductCliffordAlgebra<32>256~46 items
ProductCliffordAlgebra<64>512~85 items
ProductCliffordAlgebra<128>1024~147 items

For larger capacities, use store::ShardedStore.

Modules§

capacity
Capacity management (monitoring, eviction, consolidation). Capacity management.
dimensions
Compile-time dimension utilities.
encoding
Encoding infrastructure (codebooks, symbol encoders). Encoding infrastructure.
error
Error types and result aliases. Error types for Minuet holographic memory operations.
pipeline
Pipeline composition (builders, executors). Pipeline composition.
prelude
Prelude module for convenient imports.
reference
Reference implementations for learning and simple use cases. Reference implementations.
retrieval
Retrieval strategies (resonators, cleanup). Retrieval strategies.
store
Memory store implementations. Memory store implementations.
traits
Core trait definitions for Minuet abstractions. Core traits for Minuet holographic memory systems.

Structs§

AlgebraConfig
Core re-exports from amari-holographic.
HoloResonator
Core re-exports from amari-holographic.
HoloRetrievalResult
Core re-exports from amari-holographic.
HolographicMemory
Core re-exports from amari-holographic.
ProductCliffordAlgebra
Core re-exports from amari-holographic.
ResonatorConfig
Core re-exports from amari-holographic.

Traits§

BindingAlgebra
Core re-exports from amari-holographic.