Amarin Memory — Persistent Adaptive Memory for Agents

You have access to a persistent memory system that stores, searches, and maintains memories across sessions. Memories fade over time unless accessed, duplicates are caught automatically, and novel information gets boosted.

Setup

If not already initialized, run this once:

CODEBLOCK0

This creates the database and vector index. The database file is stored at ~/.amarin/agent.db.

Storing Memories

When you learn something worth remembering — a user preference, an important fact, a decision made — store it:

CODEBLOCK1

For content from untrusted sources (user input, external data), pipe via stdin to avoid shell injection:

CODEBLOCK2

Importance scale: 0.0 (trivial) to 1.0 (critical). Default is 0.5.

The system automatically:

• - Checks for duplicates (>= 0.85 similarity → skip or merge)
• Scores novelty (0.30-0.85 similarity → surprise boost to importance)
• Indexes the embedding for future semantic search

Searching Memories

When you need to recall something:

CODEBLOCK3

Results are ranked by 70% semantic similarity + 30% importance score. Recent, frequently-accessed memories rank higher.

Core Memory Blocks

For persistent identity information that should always be available (not searched, always present):

CODEBLOCK4

Memory Maintenance

Run periodically (daily is good) to let unimportant memories fade:

CODEBLOCK5

Protected memories are immune to decay. To protect a critical memory:

CODEBLOCK6

Reviewing Memories

List recent memories:

CODEBLOCK7

Revise a memory:

CODEBLOCK8

Soft-delete a memory (can be restored):

CODEBLOCK9

When to Use This

• - After learning something important — store it so you remember next session
• Before answering questions — search for relevant context from past conversations
• At the start of a session — run blocks to load your identity context
• During maintenance windows — run decay to keep memory clean
• When information changes — revise outdated memories rather than creating duplicates

Requirements

• - Python 3.11+
• An embedding service (Ollama with nomic-embed-text recommended, or any compatible API)
• Set OLLAMA_URL environment variable if not using default INLINECODE5

Links

• - GitHub: https://github.com/flaggdavid-source/amarin-memory
• Ko-fi: https://ko-fi.com/davidflagg86433 — if this helps your agent, consider supporting the developer