Skip to main content

​
Memory Engine

This is where you control how your character remembers things. Without memory, your character forgets every conversation the moment it ends. With memory turned on, your character can remember what users said to it days, weeks, or even months ago. How to get here:
Go to your character’s dashboard → left sidebar → click Universal → click Memory Engine
The full path is: Universal → Memory Engine This section has two sub-pages:
  1. Configuration — settings for how memory works (the “rules”)
  2. Memories — the actual list of things your character currently remembers

​
Configuration

Full path: Universal → Memory Engine → Configuration The Configuration page has four tabs across the top: General, Decay, Importance, and Scoring.

​
General Tab

Full path: Universal → Memory Engine → Configuration → General This is the master control panel for the memory system. System Settings
SettingWhat it doesDefault
Enable Memory System (toggle)The on/off switch for the entire memory system. Turn it off and the character remembers nothing between conversations. Turn it on and memory is active.On
Memory Context Size (1–20)How many memories the character “looks at” before writing each reply. Think of it like how many sticky notes it checks before answering. Higher = checks more notes = smarter but slower.10
Relevance Threshold (0.01–1.0)How closely a memory has to match the current conversation topic before the character uses it. Think of it like a confidence score. Low = the character uses more memories even if they’re not closely related. High = only very relevant memories get used.0.10
Cleanup Threshold (0.01–0.5)Memories with an importance score below this number get automatically deleted during cleanup. Low = keep almost everything. High = only keep very important memories.varies
If responses feel slow, try lowering Memory Context Size to 5 or 7. The character will check fewer memories per reply, which speeds things up.

​
Decay Tab

Full path: Universal → Memory Engine → Configuration → Decay This controls how fast memories “fade away” over time. Just like how humans forget things they haven’t thought about in a while, your character’s memories also fade if they aren’t reinforced. Rule: Higher number = fades faster. Lower number = lasts longer. Each type of memory has its own decay rate because different types of memories are naturally expected to last different amounts of time:
Memory TypeDefault Decay RateHow long it typically lasts
Short-term0.1000Hours to a day or two
Working0.0500A few days
Episodic0.0100A few weeks
Semantic0.0010Several months
Long-term0.0001Years
Think of it like this:
  • Short-term = like remembering you just had a sandwich
  • Working = like remembering a task you’re working on this week
  • Episodic = like remembering a specific event or conversation from last month
  • Semantic = like remembering a fact you learned years ago
  • Long-term = like remembering your own name

​
Importance Tab

Full path: Universal → Memory Engine → Configuration → Importance This controls the minimum importance score a memory must have to survive cleanup. Memories below the threshold for their type are removed or ignored. Think of it like a filter: “Only keep memories that are important enough.”
Memory TypeDefault ThresholdTimeframe
Short-term0.30Hours to days
Working0.40Days
Episodic0.50Weeks
Semantic0.60Months
Long-term0.70Years
  • Raise a threshold = the character becomes more selective — only high-importance memories survive for that type.
  • Lower a threshold = the character keeps more of everything, even minor details.

​
Scoring Tab

Full path: Universal → Memory Engine → Configuration → Scoring This controls how the system scores memories when deciding which ones to pull up during a conversation. The three weights must always add up to exactly 1.0 (100%). Think of it like deciding what’s most important when searching your own memory:
  • Do you prioritize memories related to the current topic?
  • Do you prioritize the most important memories overall?
  • Do you prioritize the most recent memories?
WeightDefaultWhat it prioritizes
Similarity Weight0.25Memories that are topically close to the current conversation
Importance Weight0.50Memories that were rated as more important when stored
Recency Weight0.25Memories that were created or last reinforced recently
At the bottom of this tab you’ll see a Total Weight display that shows the live sum of all three. It must read 1.00 — the page will warn you if it doesn’t. Practical adjustments:
  • Want the character to focus on recent events? → Increase Recency Weight.
  • Want the character to stay on-topic? → Increase Similarity Weight.
  • Want all memories treated equally? → Lower Importance Weight and raise the others.

​
Memories

Full path: Universal → Memory Engine → Memories This is the list of everything your character currently remembers. You can search it, filter it, and manage individual memories.

​
Stored Memories

ControlWhat it does
Search barType any word or phrase to search through all stored memories.
All Types dropdownFilter the list to only show one type of memory (short-term, working, episodic, etc.).
Total countShows how many memories currently exist total.
You can click on any individual memory to inspect it, and you can delete individual memories you no longer want.

​
Learning Queue

Below the memory list, there is a Learning Queue section. This is a list of facts the character picked up from conversations that it thinks might be worth remembering permanently. Each item in the queue shows:
  • The fact it learned (e.g., “The user said their name is Alex”)
  • A category tag (e.g., user fact, world fact)
  • A score out of 5 indicating how likely it is to be a useful memory
For each item, you can:
  • Click Approve → the fact becomes a permanent memory
  • Click Reject → the fact is discarded
  • Use the Search bar to find specific items
  • Click Refresh to reload the queue with any new items
The Learning Queue is where your character “learns” from real conversations. Check it periodically to approve important facts and reject irrelevant ones. This keeps your character’s memory accurate and useful.

​
Danger Zone

At the very bottom of the Memories page, there is a section called Danger Zone with two permanent actions:
ActionWhat it does
Wipe All MemoriesPermanently deletes EVERY memory the character has accumulated. The character starts completely fresh with no memory of any past conversation.
Clear Learning QueueRemoves all items from the Learning Queue without approving any of them.
Both of these actions are permanent and cannot be undone. Once memories are wiped, they are gone forever. The character will not remember any past conversations.