README.md

---
title: Mnemo v4
emoji: 🧠
colorFrom: purple
colorTo: blue
sdk: docker
pinned: false
license: mit
short_description: SLM-Inspired Memory System with Neural Links
---

# 🧠 Mnemo v4.1 - SLM-Inspired Memory System

Advanced memory system for LLMs with **neural links**, **memory decay**, and **smart injection**.

## Features

- 🔗 **Neural Links** - 8 link types connecting related memories
- 📊 **Three-Tier Memory** - Working → Token → Semantic hierarchy  
- 🎯 **Smart Injection** - Predicts when to use memory vs skip
- ⏰ **Memory Decay** - Unused memories fade (1%/day), pruned after 30 days
- ⚙️ **Self-Tuning** - Parameters adjust based on feedback

## Benchmark Results

| Test | Without Memory | With Mnemo |
|------|----------------|------------|
| Novel retrieval | 5% | 85% |
| Code retrieval | 60% | 88% |
| ROS learning | 25% | 75% |

## Usage

1. **Add memories** in the Memory Store tab
2. **Search** to find related content  
3. **Smart Injection** tells you when memory helps

[Library](https://huggingface.co/AthelaPerk/mnemo-memory) | [MCP Server](https://huggingface.co/spaces/AthelaPerk/mnemo-mcp) | MIT License