Downloads ยท 30 days
110
26% of all-time downloads
yuanqianhao/MemSearcher-3B
MemSearcher-3B is a text generation model from yuanqianhao. Use it when you need the model to write or continue text. It is set up for transformers. The card lists the license as apache-2.0.
<p align="center" ๐ <a href="https://arxiv.org/abs/2511.02805"Paper</a | ๐ป <a href="https://github.com/icip-cas/MemSearcher"Code</a </p
Downloads ยท 30 days
110
26% of all-time downloads
All-time downloads
428
Public
Parameters
3.4B
6.8 GB on disk
Likes
1
Public
Click a slice to open those files.
.safetensors6.8 GB ยท 100%
From the Hugging Face model README
MemSearcher-3B is a search agent built on Qwen/Qwen2.5-3B-Instruct and trained with
multi-context GRPO, the end-to-end reinforcement-learning method introduced in
MemSearcher.
Unlike ReAct-style agents that concatenate the entire interaction history into the context โ producing long, noisy inputs and linearly growing compute โ MemSearcher maintains a compact, iteratively-updated memory. At every turn the backbone LLM sees only two short inputs, the question and the current memory, then it reasons, decides whether to search, and rewrites the memory to keep only question-relevant information. This keeps the context length nearly constant across turns without sacrificing accuracy.
Exact Match (EM) on seven single- and multi-hop QA benchmarks (Wikipedia-18 corpus):
| Model | NQ | TriviaQA | PopQA | HotpotQA | 2Wiki | MuSiQue | Bamboogle | Avg. |
|---|---|---|---|---|---|---|---|---|
| MemSearcher 3B | 47.0 | 63.8 | 47.9 | 43.9 | 43.5 | 17.9 | 42.4 | 43.8 |
| MemSearcher 7B | 52.7 | 68.1 | 47.8 | 50.8 | 48.6 | 25.8 | 48.8 | 48.9 |
| MemSearcher 14B | 53.7 | 71.1 | 48.8 | 51.8 | 51.5 | 27.2 | 57.6 | 51.7 |
This card is for the 3B model (highlighted row).
At turn i the context is just (question, memory_{i-1}). The model:
<think>...</think>;wikipedia_search tool call), or answers in \boxed{} when the memory suffices;Training uses multi-context GRPO: it samples a group of trajectories, then propagates each trajectory's advantage to all of its per-turn contexts, enabling stable end-to-end optimization of reasoning, search, and memory management.
MemSearcher is an agent that needs a Wikipedia retriever and the multi-turn orchestration loop. The simplest path is the released code:
git clone https://github.com/icip-cas/MemSearcher && cd MemSearcher
# 1) start the wiki-18 retriever (see README "Retriever Serving")
# 2) serve this model with SGLang
MODEL_PATH=yuanqianhao/MemSearcher-3B TP=2 PORT=80 bash launch_server.sh
# 3) run the agentic evaluation
GENERATOR_MODEL=yuanqianhao/MemSearcher-3B DATA_DIR=./data SAVE_DIR=./eval \
SGL_REMOTE_URL=http://127.0.0.1:80 RETRIEVER_URL=http://127.0.0.1:8000/search bash eval.sh
The model weights load with standard transformers (AutoModelForCausalLM.from_pretrained("yuanqianhao/MemSearcher-3B")),
but reproducing the reported numbers requires the retriever + agent loop above.
Trained on the NQ + HotpotQA training split โ the same data as Search-R1 โ re-wrapped into MemSearcher's re_call format. See the code repository for the exact preparation script.
@article{yuan2025memsearcher,
title={MemSearcher: Training LLMs to Reason, Search and Manage Memory via End-to-End Reinforcement Learning},
author={Yuan, Qianhao and Lou, Jie and Li, Zichao and Chen, Jiawei and Lu, Yaojie and Lin, Hongyu and Sun, Le and Zhang, Debing and Han, Xianpei},
journal={arXiv preprint arXiv:2511.02805},
year={2025}
}
Released under Apache-2.0, following the base model Qwen/Qwen2.5-3B-Instruct.