Skip to content

Reuse a per-session context across chat exchanges - #215

Open
james-333i wants to merge 4 commits into
huggingface:mainfrom
james-333i:feat/llama-session-context
Open

Reuse a per-session context across chat exchanges#215
james-333i wants to merge 4 commits into
huggingface:mainfrom
james-333i:feat/llama-session-context

Conversation

@james-333i

Copy link
Copy Markdown
Contributor

Every generation created a fresh llama_context and prefilled the full conversation from token zero, so multi-turn cost grew with the square of the transcript. This keeps one context alive per session, reuses the longest shared token prefix, and decodes only the remainder. Backends that cannot rewind fall back to a full decode, and any generation error discards the cached context. Stacks on the Gemma 4 PR.

streamResponse consumed an inner AsyncThrowingStream whose builder ran
the entire generation loop synchronously on the consuming task, so
every snapshot buffered and arrived in one burst after generation
finished.

Yield snapshots directly from the generation loop on the streaming
task, and check for task cancellation between tokens so an abandoned
stream stops decoding promptly.
Image segments threw unsupportedFeature because the backend had no
multimodal path, even though the prebuilt llama.cpp binaries ship the
mtmd library and its helpers.

Accept an mmprojPath at initialization and load the projector next to
the model. When a projector is present, prompt formatting replaces
each image segment with the mtmd media marker and collects payloads in
order, then generation tokenizes the marker-annotated prompt with
mtmd_tokenize and evaluates text and image chunks through
mtmd_helper_eval_chunks before sampling continues from the resulting
position. Both respond and streaming support images, and models
without a projector keep rejecting image input.

Adds live tests generating from an embedded test image through both
paths.
Gemma 4's canonical chat template no longer contains the
start_of_turn marker that llama_chat_apply_template keys its Gemma
detection on, so formatting threw encodingFailed for every Gemma 4
GGUF.

When template application fails and the embedded template carries the
Gemma 4 turn syntax, render it directly: turns open with a turn
marker and role, close with the reverse marker, the assistant role is
named model, and generation opens a model turn. The BOS token is
applied during tokenization, and thinking is opt-in in this format so
no suppression is needed.
Every generation created a fresh llama_context and prefilled the full
rendered conversation from token zero, so multi-turn chat cost grew
with the square of the transcript and long conversations spent most of
their time re-decoding history.

Keep one context alive per session for plain chat generations. Each
exchange tokenizes the rendered prompt, keeps the longest token prefix
shared with the context's recorded state, removes diverged state with
llama_memory_seq_rm, and decodes only the remainder. Backends that
cannot rewind, such as recurrent models, fall back to clearing memory
and decoding the full prompt, and appends need no rewind on any
backend. The final prompt token is always re-decoded so sampling has
fresh logits, generated tokens extend the recorded state as they
decode, and any generation error discards the cached context.

Structured generation, image prompts, and encoder models keep
single-use contexts, and clearCachedContext lets consumers free the
cached state under memory pressure.

Adds a live test asserting prefix reuse on the second turn of a
session.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant