Mandol Documentation

This documentation tracks the current src/mandol package in this checkout. The maintained public surface is based on MemoryUnit, MemorySpace, SemanticMap, SemanticGraph, MultiRetriever and the retrieval-facing subpackages.

Historical pages from earlier architecture experiments are preserved under docs/archive/ for design provenance. They are excluded from the Sphinx build and are not an API contract for the current package.

Current Code Guide

• Installation
  • Published package
  • Source environments
  • Recommended development environment
  • Runtime-only environment
  • Optional groups and extras
  • Verify the install
  • Important dependency note
• Quick Start
  • Minimal semantic graph
  • Multi-method retrieval
  • Save and load
• Core Data Structures
  • MemoryUnit
  • MemorySpace
  • SemanticMap
  • SemanticGraph
  • Canonical tower spaces
• Retrieval
  • Available methods
  • Basic search
  • Quantified search
  • Async reranking with vLLM
  • Three-tower retrieval
• Persistence
  • SemanticGraph snapshots
  • Automatic payload paging
  • SemanticMap snapshots
  • Index behavior
• Configuration
  • Model presets
  • Environment variables
  • Optional runtime tuning
• Reproduction and Benchmarks
  • Branch roles
  • Main-branch workflows
  • Performance scope
• Current API Reference
  • Top-level package
  • Core helpers
  • Retrieval package
  • Three-tower retrieval
  • Other retrieval-facing packages
  • High-level memory construction
  • Routing and quantification
  • Providers, storage and clustering

Indices

• Index

• Search Page