Struct HirnMemory 

pub struct HirnMemory { /* private fields */ }

Zero-config memory API.

Discovers providers from environment variables automatically:

Variable	Effect
OPENAI_API_KEY	Uses OpenAI embeddings + LLM
OLLAMA_HOST	Uses Ollama embeddings + LLM
(none)	Fails unless allow_pseudo_embedder_fallback = true, then uses PseudoEmbedder for explicit dev/test mode

Implementations

impl HirnMemory

pub async fn open(path: impl AsRef<Path>) -> HirnResult<Self>

Open (or create) a brain at the given path.

Provider discovery runs automatically — set OPENAI_API_KEY or OLLAMA_HOST for real embeddings. When no real embedder is configured, this open path fails unless hirn.toml or HirnConfig explicitly sets allow_pseudo_embedder_fallback = true for development or testing.

If a hirn.toml file exists in the brain directory, its values override the defaults. Use open_with_config for full programmatic control (HirnConfig > hirn.toml > defaults).

pub async fn open_with_config(config: HirnConfig) -> HirnResult<Self>

Open with an explicit HirnConfig.

The provided config takes full precedence — hirn.toml is not auto-loaded. Use open for auto-configuration.

pub async fn remember(&self, text: &str) -> HirnResult<MemoryId>

Store a text memory with automatic embedding and entity extraction.

Returns the assigned MemoryId.

pub async fn think(&self, query: &str, budget: usize) -> HirnResult<ThinkResult>

Assemble optimal LLM context for a query under budget tokens.

budget is capped at MAX_TOKEN_BUDGET (128 000 tokens — the largest commercially available context window as of 2026). Passing a larger value returns HirnError::InvalidInput.

pub async fn recall( &self, query: &str, limit: usize, ) -> HirnResult<Vec<RecallResult>>

Recall memories relevant to a query.

pub async fn query(&self, hirnql: &str) -> HirnResult<QueryResult>

Execute a HirnQL query string.

Returns QueryResult for the embedded HirnQL statement classes that remain supported on the authoritative engine bridge.

Graph mutation, policy mutation, watch, and other direct-only surfaces are intentionally not available through query() and should use the corresponding view or daemon APIs instead.

Parse errors include line/column position information.

pub fn db(&self) -> &HirnDB

Get a reference to the underlying HirnDB for advanced operations.

pub fn db_mut(&mut self) -> &mut HirnDB

Get a mutable reference to the underlying HirnDB.

pub fn recall_builder(&self, about: &str) -> MemoryRecallBuilder<'_>

Fluent recall builder that accepts text and auto-embeds on execute.

let results = memory.recall_builder("auth")
    .episodic_only()
    .limit(20)
    .activation(ActivationMode::Spreading)
    .depth(2)
    .execute()
    .await?;

pub fn think_builder(&self, about: &str) -> MemoryThinkBuilder<'_>

Fluent think builder that accepts text and auto-embeds on execute.

let ctx = memory.think_builder("deployment strategies")
    .budget(4096)
    .episodic_only()
    .execute()
    .await?;