MemSkill  by ViktorAxelsen

Self-evolving agents with learned and evolving memory skills

Created 1 month ago
313 stars

Top 86.5% on SourcePulse

GitHubView on GitHub
Project Summary

MemSkill is a framework for learning and evolving memory skills for long-horizon agents. It addresses the limitations of static memory operations by employing a data-driven loop where skills are learned, refined, and reused based on task feedback. This enables more adaptive memory construction, improving agent performance and generalization across diverse settings.

How It Works

The core approach involves skill-conditioned memory construction, where a small set of relevant skills is composed for each interaction span. Skills are continuously refined through an "evolution" process, mining challenging examples to improve existing skills and propose new ones. A reusable skill bank facilitates knowledge transfer across different datasets and base models, promoting efficiency and adaptability.

Quick Start & Requirements

Installation involves cloning the repository, creating a Conda environment with Python 3.10, and installing specific versions of vLLM (0.6.3), PyTorch (2.6.0 with CUDA 12.4 support), and Flash-Attention. The primary installation command sequence is:

git clone https://github.com/ViktorAxelsen/MemSkill
cd MemSkill
conda create -n memskill python=3.10
conda activate memskill
pip install vllm==0.6.3
pip install torch==2.6.0 torchvision==0.21.0 torchaudio==2.6.0 --index-url https://download.pytorch.org/whl/cu124
pip install flash-attn --no-build-isolation
pip install -r requirements.txt

Users must also download and prepare data for supported datasets like LoCoMo, LongMemEval, HotpotQA, and ALFWorld. Links to official dataset sources are provided within the README.

Highlighted Details

  • Skill Evolution: Dynamically refines and proposes memory skills based on performance on challenging examples.
  • Skill-Conditioned Construction: Composes memories by selecting and combining relevant skills for specific interaction spans.
  • Reusable Skill Bank: Centralized, evolving repository of skills enabling transfer learning across tasks and models.
  • High-Throughput Evaluation: Employs multi-API-key round-robin for stable, parallel inference calls.
  • Scalability: Leverages multi-threading and multi-processing for large-scale training and evaluation.

Maintenance & Community

The project was featured by HuggingFace as a "Paper of the Day" in February 2026, indicating recent attention. No specific community channels (e.g., Discord, Slack) or explicit contributor details are provided in the README.

Licensing & Compatibility

The README does not specify a software license. This absence creates ambiguity regarding usage rights, commercial compatibility, and derivative works.

Limitations & Caveats

MemSkill represents a novel paradigm for agent memory, implying it is research-oriented and potentially subject to ongoing development. Setup requires specific, potentially cutting-edge dependencies (e.g., PyTorch 2.6.0 with CUDA 12.4, vLLM 0.6.3) and significant effort for data preparation across multiple benchmark datasets. The lack of explicit licensing information is a notable adoption blocker.

Health Check
Last Commit

6 days ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
264 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.