jeff-adapter-tools-gguf
The LoRA GGUF of jeff-adapter-tools (Jeff v1.3), for llama.cpp.
Agent tool choice. Picks the next tool for an AI agent to call, or says to answer directly or to ask the user for missing information.
This repository holds only the adapter. Load it on top of the base GGUF from mstrasser/jeff-base-gguf; there is no separate full model per adapter.
It works on either base format: Q8_0 (recommended, within 0.4 points of full precision on every adapter test) or Q4_K_M (within 0.4 points).
Files
| File | What it is |
|---|---|
loras/tools.gguf | The LoRA (169 MB), the same file for every base format. It stays at full precision; quantisation applies to the base weights only |
models/tools.jeff.json | What a client needs: the answer codes and their token ids, the prompt layout (live-last) and the temperature fitted for each format |
tools.jeff.json has a temperature for each format (temperature_by_format: f16, q8_0, q4_k_m); use the one for
your base format, so the probabilities stay calibrated.
Results
The same test, through llama.cpp: the base GGUF plus this LoRA GGUF, with the temperature refitted for each format. Running Jeff with llama.cpp
| Test set | Full precision | Q8_0 | Q4_K_M |
|---|---|---|---|
test | 97.2% · 0.007 | 97.2% · 0.005 | 97.1% · 0.010 |
All results, and the same test at full precision against the untrained model and the base alone: jeffhub.ai/adapters/tools.
How to run it
Use llama.cpp commit cb7934c52ca8710994b2ecc19775ebefcfdb8d01 or newer: it needs the qwen35 architecture and LoRA
on the output layer.
hf download mstrasser/jeff-base-gguf --local-dir jeff-gguf
hf download mstrasser/jeff-adapter-tools-gguf --local-dir jeff-gguf
cd jeff-gguf
llama-server -m models/base-q8_0.gguf -c 8192 -np 1 --lora-init-without-apply --lora loras/tools.gguf
Jeff is not a chat model. For each decision you run one forward pass over the prompt and read the probabilities of the answer codes; you never sample text.
- Build the prompt exactly as Jeff does (the question, the state, the options as answer codes, and the changing
state field under "Latest", then the chat template with thinking off). The Jeff repository builds it for you
(
jeff.model.decision_messages). - Tokenize without a beginning-of-sequence token, with special tokens parsed.
- Run one forward pass over the whole prompt from an empty state, with this adapter active. Clear the state between prompts: Qwen3.5 has recurrent layers, so a reused state would carry over.
- Read the probabilities. Take the logits of the first N answer-code tokens (
token_ids[:N], N = the number of options), divide by the temperature for this adapter and your format, and apply a softmax over those N.
With llama-server, each decision is one POST /completion with "n_predict": 1, "cache_prompt": false, a lora
list that names every loaded adapter (scale 1 for this one, 0 for the rest; an adapter left out of the list keeps
scale 1.0), a logit bias of +1000 on every answer-code token of the request, and n_probs set to the number of
options. From the llama.cpp library: load the base once with llama_model_load_from_file, this adapter once with
llama_adapter_lora_init, and per request call llama_set_adapters_lora with scale 1, clear the memory, decode once
and read llama_get_logits_ith(ctx, -1).
The full guide, with an example prompt and request: Running Jeff with llama.cpp.
Data and licence
Adapter licence: Apache-2.0.
Qwen3.5-0.8B notice: these weights were modified from Qwen3.5-0.8B by the Jeff project: jeff-base is a fine-tune of Qwen3.5-0.8B, and this adapter was trained on top of it. Qwen3.5-0.8B is Copyright 2026 Alibaba Cloud and licensed under the Apache License, Version 2.0; a copy of that licence is in LICENSE.
It was trained on:
-
Generated agents, tool sets and user messages. Licence: Released with the adapter under Apache-2.0 (made for this adapter) · Made by Qwen3.8-Max (hosted) and Qwen3.8-Flash-Next (local); see the data card
About 450 agents with their tool lists (including deliberate near-duplicate tools) and 39,203 training rows, written by language models and checked by code and a second pass (which models, and for how many rows, is in the data card).
Links
- The adapter at full precision: mstrasser/jeff-adapter-tools (revision v1.3)
- The base GGUF: mstrasser/jeff-base-gguf
- Adapter page: jeffhub.ai/adapters/tools
- Running Jeff with llama.cpp: jeffhub.ai/docs/llama-cpp
Jeff is an independent project. It uses the same request format as Jev but is not affiliated with or endorsed by TypeSafe, the makers of Jev.