hmc-memory 2.3.0

Long-term memory for AI agents. v2.3 adds Inheritance + Federation, MCP v2.3 (10 new tools), L2 Inject endpoint, Vietnamese FTS.

MemoryAI — Long-term Memory for AI Agents

Your AI never forgets. Preferences, decisions, context — remembered forever.

Install

Note: Package name is hmc-memory because memoryai was squatted on PyPI in 2024.
Import name remains memoryai for clean code: from memoryai import MemoryAI.

pip install hmc-memory

Quick Start

from memoryai import MemoryAI

mem = MemoryAI(api_key="hm_sk_your_key")

# Store a memory
mem.store("User prefers dark mode", memory_type="preference")

# Recall
results = mem.recall("what does user prefer")
for r in results:
    print(f"[{r['score']:.0%}] {r['content']}")

# Bootstrap (start of session)
context = mem.bootstrap("working on payment feature")
# → Returns ~800 token context block with identity + mood + goals

# Save (end of session)
mem.save("Built payment API with Stripe. User decided on webhook approach.")

# Profile
profile = mem.profile()
print(profile["persona"])
print(profile["mood"])

API

MemoryAI(api_key, endpoint, timeout, graceful)

Param	Default	Description
api_key	required	Your API key (hm_sk_...)
endpoint	https://memoryai.dev	API endpoint
timeout	30	Request timeout (seconds)
graceful	False	Never raise errors, return empty instead

Methods

Method	Description
store(content, memory_type, tags)	Store a memory
recall(query, limit, depth, since)	Search memories
bootstrap(task, mode)	Wake up with context (session start)
save(content)	Save session summary (session end)
profile()	Get cognitive profile (persona, mood, goals)
health()	Check memory stats
guard_check(tokens, max_tokens)	Check context pressure

Memory Types

Type	Lifespan	Use for
preference	Forever	User likes/dislikes
decision	Forever	Choices made
identity	Forever	Who the user is
procedure	Forever	How to do things
fact	Decays	General knowledge
goal	Until done	Active objectives

Zero Dependencies

Pure Python stdlib (urllib). No requests, no httpx, no aiohttp. Works everywhere Python runs.

Links

• Documentation
• Setup Guide
• Get API Key