t-tech/T-Search-GGUF

T-Search-GGUF

🚨 T-Search-GGUF is designed for use with the [official T-Search harness](https://github.com/turbo-llm/t-search-harness). The source T-Search checkpoint did not show noticeable differences relative to the Qwen3.6-35B-A3B base model on general-purpose benchmarks.

🚨 Users are advised to exercise caution and are responsible for any additional training and oversight required to ensure the model's responses meet acceptable ethical and safety standards. The responsibility for incorporating this model into industrial or commercial solutions lies entirely with those who choose to deploy it.

Highlights

We introduce T-Search-GGUF, a set of GGUF quantizations of the T-Search agentic retriever for difficult multi-step search in English and Russian. T-Search plans and executes searches across multiple rounds with a configurable search budget.

• —GGUF checkpoints: calibrated Q4KM, Q5KM, Q6K, and Q80 quantizations for deployment with llama.cpp.
• —Production-aligned calibration: importance-matrix calibration includes a deterministic, balanced sample of English and Russian production SFT traces.
• —Embedded MTP: each GGUF contains the model's MTP head and can use self-speculative decoding without a separate draft checkpoint.
• —Agentic retrieval: issues queries, inspects results, tracks coverage, carries compact evidence and search state across rounds, and returns a ranked chunk set.
• —Retrieval quality: outperforms the base model and larger open models on average across the evaluated retrieval benchmarks.
• —Retriever robustness: trained and evaluated with multiple retrievers, maintaining strong retrieval quality across configurations.

Description

T-Search-GGUF is built from the BF16 `t-tech/T-Search` checkpoint. T-Search is based on Qwen3.6-35B-A3B and trained on fully synthetic search tasks generated for the same harness used at inference time.

The model is responsible for collecting evidence. Given a question and access to a corpus search backend, it formulates queries, reads retrieved snippets, decides which chunks are worth preserving, and returns a ranked evidence set. A downstream generator, reranker, or full-text fetcher can then consume that ranking.

⛷️ T-Search Harness

The official T-Search harness implements the inference protocol used for training and evaluation. The retriever operates in rounds. Within each round, it follows a ReAct loop with an approximately 32K-token context budget and three tools:

• —search_corpus searches the corpus and returns document chunks;
• —save_and_advance preserves important chunks and starts a new round;
• —finalize_ranking ends the search and returns a ranked evidence set.

The agent sees the original question, previously saved chunks, and the current coverage state: which parts of the question are supported by evidence and which remain open. It chooses search queries, inspects retrieved chunks, and decides whether to continue searching, preserve state for another round, or finalize.

At 75% context utilization, search_corpus is locked. The agent must either call finalize_ranking or use save_and_advance to build compact memory for the next round: preserved chunks with reasons, covered and open parts of the question, previous attempts, and a useful next step. Full tool history and intermediate noise do not cross the round boundary.

🧠 Training

Training proceeds in two stages: supervised fine-tuning on fully synthetic search trajectories, followed by reinforcement learning with GSPO and recall-based rewards. At each stage, separate English and Russian experts are trained on language-specific data and then merged into a single checkpoint.

Quantization

The GGUF files were produced from the BF16 `t-tech/T-Search` checkpoint using `llama.cpp`.

An importance matrix was computed from a production-aligned calibration corpus that includes a deterministic 50/50 sample of English and Russian SFT traces.

The model's MTP/NextN layer is embedded directly in every GGUF file. Q4KM, Q5KM, and Q6K use Q40 for the MTP tensors, while the Q80 release keeps them in Q80. No separate MTP sidecar is required.

The release was converted, calibrated, quantized, and validated with `llama.cpp` build b10068, commit 571d0d540df04f25298d0e159e520d9fc62ed121.

Synthetic task factory

Training tasks contain a question, a fixed index, annotated evidence chunks, and a full tool-use trajectory. Candidate tasks pass adversarial checks for trivial query leakage, answerability from model weights, single-document shortcuts, missing evidence, and weak distractors.

Supervised fine-tuning

Long teacher trajectories are split into self-contained rounds. Invalid tool actions are masked from the loss, while useful recovery behavior after a tool error is retained. Productive rounds are selected by evidence gain rather than by final recall alone, preserving useful behavior from difficult tasks.

Training uses 11K SFT examples from 8K unique questions per language; one quarter targets robustness to different retrievers. An additional non-overlapping pool of 2K questions per language is reserved for RL.

Reinforcement learning

The policy is optimized with GSPO. RL optimizes the complete search policy on full tool-use trajectories. The main reward is recall over gold chunk_id values; precision and F-score are tracked for diagnostics but are not used as the primary training signal. This discourages the agent from finalizing early with a small high-precision but incomplete evidence set.

A detailed Russian-language training report will be available soon on Habr.

📊 Benchmarks

The reference results below are reproduced from the BF16 T-Search evaluation. GGUF results measured with the same harness and fixed benchmark indices are reported separately.

Evaluation datasets

The accompanying evaluation datasets are released as **TRuST** and **SynthComp**.

We use Recall@10 as the primary metric.

We report single-rollout results for all models and, for T-Search, an additional N=3 configuration that runs three independent rollouts in parallel and combines their rankings using reciprocal rank fusion (RRF).

GGUF evaluation

The results below use the same T-Search harness, fixed benchmark indices, retriever configuration, generation parameters, 65,536-token serving context, and single-rollout (N=1) setup for every evaluated checkpoint. The original BF16 t-tech/T-Search checkpoint is included as a reference.

We also study the latency–quality trade-off by varying the maximum number of search rounds and the number of parallel agent runs. This separates the effect of deeper sequential search from broader parallel exploration.

To evaluate retrieval robustness, we varied the search backend while keeping the model and agent configuration fixed.

👨‍💻 Usage

Recommended generation parameters

do_sample: true
temperature: 0.7
top_p: 1.0

Serve t-tech/T-Search-GGUF through an OpenAI-compatible endpoint. See the harness README for installation and search-backend integration.

Reference llama.cpp serving setup

Use llama.cpp build b10068 or newer. The following configuration starts an OpenAI-compatible server with the embedded chat template, structured tool calling, separated reasoning output, and the embedded MTP head:

llama-server \
  --model "/path/to/T-Search-Q4_K_M.gguf" \
  --alias "t-tech/T-Search-GGUF" \
  --host 0.0.0.0 \
  --port 8000 \
  --n-gpu-layers all \
  --flash-attn on \
  --fit off \
  --ctx-size 65536 \
  --parallel 1 \
  --jinja \
  --reasoning on \
  --reasoning-format deepseek \
  --spec-type draft-mtp \
  --spec-draft-n-max 4 \
  --spec-draft-p-min 0.0 \
  --spec-draft-ngl all

Here, deepseek selects the OpenAI-compatible reasoning serialization format; it does not refer to the model architecture. With --jinja, llama.cpp uses the embedded T-Search chat template and exposes structured tool calls to the harness.

The context size is shared across parallel slots. To preserve a 65,536-token context for each concurrent request, set:

ctx-size = parallel × 65536

For example, eight concurrent requests require --parallel 8 --ctx-size 524288.

For a two-GPU layer split, add:

--split-mode layer \
--tensor-split 1,1

Example

from retriever_agent import (
    AgentConfig,
    HttpSearchClient,
    OpenAILLMClient,
    RetrieverAgent,
)

config = AgentConfig(model="t-tech/T-Search-GGUF")
llm = OpenAILLMClient(["http://<llama-host>:8000/v1"], config)
search = HttpSearchClient("http://<search-host>:8000")

agent = RetrieverAgent(config, llm, search)
result = agent.retrieve("your query")

for doc in result.documents:
    print(doc.rank, doc.doc_id, doc.score, doc.text)