Memory & Context

If the Character Definition is the soul of the AI, then Memory is its conscience. It is the persistent thread that ties your interactions together, transforming a series of disjointed messages into a coherent, evolving story.

By default, AI models have a "Context Window", a limit on how much text they can rember at once. Once a conversation gets too long, the earliest messages fall off the radar. The AI effectively gets amnesia. The Memory & Context section is designed to combat this limitation, ensuring your character remembers the promises, traumas, and victories of the past.

Long-Term Memory

At the top of this section, you will find the Long Term Memory toggle. This is the master switch for the system. Keep it on. Really no need to disable it.

When enabled, the AI actively archives important details from your conversation. It moves beyond the immediate chat log and creates a permanent record of events. This ensures that if you mention your favorite color is blue in message 5, the character will still remember that preference in message 500 (if you ask properly).

The Memory Manager

For users who want total control, the Memory Manager provides a direct interface to view and edit the AI's persistent knowledge.

Manual vs. Automatic Memories

The system works on a hybrid model. It will automatically generate memories based on significant events in the chat (e.g., “The user apologized for insulting Mashiro”). However, you are also given a "+ Add" button. This allows you to manually inject facts. You can write all the history books yourself!

Why add memories manually? Sometimes the AI might miss a subtle detail, or you might want to establish a "retroactive" fact that wasn't explicitly roleplayed out. For example, you can add a memory: "We have known each other since childhood." The AI will treat this as gospel truth from that point forward, even though you just gaslit it into "knowing" you.

Understanding the Index Badges

You will notice badges on the left side of the memory items, such as "0 - 10" or "10 - 20". These indicate the priority and position of the memory within the AI's context window.

• 0 - 10 (High Priority): These memories are the freshest and most relevant.
• 10 - 20 (Lower Priority): These are older memories.

This ranking system is dynamic. As your story progresses, memories shift up and down the ranks. A memory that was crucial yesterday might slide down the list as new, more urgent events take center stage, ensuring the AI always has room to "think" about the present moment.

Advanced Context Management

While the interface looks simple, a lot happens behind the scenes to keep your story coherent.

Intelligent Compression

For our veteran roleplayers who accumulate hundreds of memories, listing them all out would eventually crash the context window. To solve this, MiocAI employs a Dense Memory Compression system.

When your memory bank gets too large, the system automatically engages a specialized AI model. It reads through your older, lower-priority memories and "compresses" them into an embedding array.

• Before: "User entered the room. User sat on the chair. User looked at the window. User sighed."
• After (Compressed): Oaoeoaoeoeaoe (you cant actually read this, its embeddings)

This happens seamlessly in the background. It allows the AI to retain the essence of months of roleplay without needing to process thousands of words of text every time it replies. You might see this condensed history in the background, often formatted as a narrative block rather than a list of raw logs.

Sync Character Memories

At the bottom of the manager, you will see the "Sync character memories" button.

This is a powerful utility for character creators. If you are in a chat where you have established deep lore or relationships, clicking this allows you to push those specific chat memories back to the global Character Definition. This means that the memories you created in this private chat can be carried over to new chats with that character, making them "canon" for your future interactions.

Best Practices for Memory

To get the most out of this system, keep these tips in mind:

1. Be Concise: Whether adding memories manually or letting the AI generate them, shorter, factual memories are more effective than long, flowery paragraphs.
2. Curate: If the AI remembers something incorrectly, don't hesitate to use the Delete button. The AI will learn to disregard that false information immediately.
3. Trust the Ranking: Don't worry if a memory falls into the "10-20" bucket. It isn't forgotten; it's just archived. The AI will pull it back up if the conversation becomes relevant to that past event.