Memory Items

A memory item is the basic unit of storage. Every piece of knowledge you store in Neocortex is a memory item.

Field
Required
Description

key

yes

Unique identifier within a namespace. Used for upsert and deduplication.

content

yes

The memory text: what the AI should remember.

namespace

yes

A scope for organizing related memories.

metadata

no

Arbitrary key-value pairs for tagging and filtering.

created_at

no

Unix timestamp (seconds) for when the memory was created.

updated_at

no

Unix timestamp (seconds) for when the memory was last updated.

If you ingest a memory item with the same (namespace, key) as an existing item, the existing item is updated rather than duplicated.

from tinyhumansai import MemoryItem

item = MemoryItem(
    key="user-preference-theme",
    content="User prefers dark mode",
    namespace="preferences",
    metadata={"source": "onboarding"},
)

Last updated