Mnemoverse Docs

Appearance

Getting Started ​

Get your first memory stored and queried in 2 minutes.

1. Get Your API Key ​

Sign up at console.mnemoverse.com to get a free API key. Free tier: 1,000 queries/day, no credit card required.

Your API key starts with mk_ and looks like: mk_live_a1b2c3d4e5f6...

2. Store a Memory ​

bash
curl -X POST https://core.mnemoverse.com/api/v1/memory/write \
  -H "X-Api-Key: mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Retry with exponential backoff fixed the timeout issue",
    "concepts": ["retry", "backoff", "timeout"],
    "domain": "engineering"
  }'

Response:

json
{
  "stored": true,
  "atom_id": "550e8400-e29b-41d4-a716-446655440000",
  "importance": 0.85,
  "reason": "novel insight — high knowledge delta"
}

The importance gate automatically filters noise. If your memory is too similar to existing ones, it won't be stored (and stored will be false).

3. Query Memories ​

bash
curl -X POST https://core.mnemoverse.com/api/v1/memory/read \
  -H "X-Api-Key: mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "how to handle timeouts?",
    "top_k": 5
  }'

Response:

json
{
  "items": [
    {
      "atom_id": "550e8400-e29b-41d4-a716-446655440000",
      "content": "Retry with exponential backoff fixed the timeout issue",
      "relevance": 0.92,
      "similarity": 0.87,
      "valence": 0.0,
      "importance": 0.85,
      "source": "semantic",
      "concepts": ["retry", "backoff", "timeout"],
      "domain": "engineering",
      "metadata": {}
    }
  ],
  "episodic_hit": false,
  "query_concepts": ["timeout", "handling"],
  "expanded_concepts": ["timeout", "handling", "retry", "backoff"],
  "search_time_ms": 12.5
}

Notice expanded_concepts — Hebbian associations automatically expanded "timeout" to include "retry" and "backoff" based on learned connections.

4. Report Outcomes ​

When a memory was useful (or not), report it:

bash
curl -X POST https://core.mnemoverse.com/api/v1/memory/feedback \
  -H "X-Api-Key: mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "atom_ids": ["550e8400-e29b-41d4-a716-446655440000"],
    "outcome": 1.0,
    "query_concepts": ["timeout", "handling"]
  }'

This does three things:

  1. Updates the memory's valence (outcome polarity) — future queries rank it higher
  2. Strengthens Hebbian edges between concepts — "timeout" and "retry" become more associated
  3. Creates co-activation links between query concepts and result concepts

Over time, the system learns which memories are useful for which queries.

5. Check Stats ​

bash
curl https://core.mnemoverse.com/api/v1/memory/stats \
  -H "X-Api-Key: mk_live_YOUR_KEY"
json
{
  "total_atoms": 1,
  "episodes": 1,
  "prototypes": 0,
  "singletons": 0,
  "hebbian_edges": 3,
  "episodic_fingerprints": 0,
  "domains": ["engineering"],
  "avg_valence": 0.8,
  "avg_importance": 0.85
}

Next Steps ​