hybrid-llama/turboquant/scripts/run-gemma4-31b-mtp-server.sh

112 lines
3.5 KiB
Bash
Executable File

#!/usr/bin/env bash
# Gemma 4 31B target + gemma4_assistant MTP draft with TurboQuant KV (turbo3 by default).
# Override paths via MAIN_GGUF, DRAFT_GGUF, or LLAMA_SERVER.
set -euo pipefail
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
SERVER="${LLAMA_SERVER:-${ROOT}/build/bin/llama-server}"
MAIN="${MAIN_GGUF:-${ROOT}/.scratch/gemma-4-31b/gemma-4-31B-it-Q4_K_M.gguf}"
# Default assistant GGUF (Q4_0 quantized; override with f16/q5/q8 by setting DRAFT_GGUF).
DRAFT="${DRAFT_GGUF:-${ROOT}/.scratch/gemma-31b-assistant-mtp-q4s.gguf}"
# Skip with VERIFY_ASSISTANT_GGUF=0
VERIFY_ASSISTANT_GGUF="${VERIFY_ASSISTANT_GGUF:-1}"
CTX="${CTX:-16384}"
NGL="${NGL:-99}"
NGL_DRAFT="${NGL_DRAFT:-99}"
# Defaults: turbo3 KV for both target and draft. Override with CTK=f16 etc. for baseline.
CTK="${CTK:-turbo3}"
CTV="${CTV:-turbo3}"
CTKD="${CTKD:-turbo3}"
CTVD="${CTVD:-turbo3}"
HOST="${HOST:-127.0.0.1}"
PORT="${PORT:-8080}"
FA="${FA:-on}"
# Toggle speculative decoding for A/B perf comparison.
# SPEC=mtp (default) - enable Gemma4 MTP assistant draft
# SPEC=off - disable speculative decoding (baseline run)
SPEC="${SPEC:-mtp}"
TEMP="${TEMP:-}"
ENABLE_METRICS="${ENABLE_METRICS:-1}"
ENABLE_SLOTS="${ENABLE_SLOTS:-1}"
LOG_TIMESTAMPS="${LOG_TIMESTAMPS:-1}"
LOG_PREFIX="${LOG_PREFIX:-1}"
NO_WARMUP="${NO_WARMUP:-0}"
if [[ ! -f "$SERVER" ]]; then
echo "error: missing ${SERVER} (build with: cmake --build build --target llama-server)" >&2
exit 1
fi
if [[ ! -f "$MAIN" ]]; then
echo "error: main GGUF not found: ${MAIN}" >&2
exit 1
fi
if [[ "$SPEC" == "mtp" ]]; then
if [[ ! -f "$DRAFT" ]]; then
echo "error: draft (assistant) GGUF not found: ${DRAFT}" >&2
echo "hint: download with: hf download google/gemma-4-31B-it-assistant --local-dir ${ROOT}/.scratch/gemma-4-31B-it-assistant" >&2
echo "hint: convert with: PYTHONPATH=${ROOT}/gguf-py python3 ${ROOT}/convert_hf_to_gguf.py ${ROOT}/.scratch/gemma-4-31B-it-assistant --outfile ${ROOT}/.scratch/gemma-31b-assistant-mtp.gguf --outtype f16" >&2
echo "hint: quantize with: ${ROOT}/build/bin/llama-quantize ${ROOT}/.scratch/gemma-31b-assistant-mtp.gguf ${ROOT}/.scratch/gemma-31b-assistant-mtp-q4s.gguf Q4_0" >&2
exit 1
fi
if [[ "$VERIFY_ASSISTANT_GGUF" != "0" ]]; then
if ! python3 "${ROOT}/scripts/verify-gemma4-assistant-gguf.py" "$DRAFT"; then
echo "error: assistant GGUF verification failed" >&2
exit 1
fi
fi
fi
PARALLEL="${PARALLEL:-1}"
ARGS=(
-m "$MAIN"
-c "$CTX"
-ngl "$NGL"
-ngld "$NGL_DRAFT"
-ctk "$CTK"
-ctv "$CTV"
-ctkd "$CTKD"
-ctvd "$CTVD"
-fa "$FA"
--host "$HOST"
--port "$PORT"
--parallel "$PARALLEL"
-np "$PARALLEL"
--cont-batching
)
if [[ "$SPEC" == "mtp" ]]; then
ARGS+=(
--mtp-head "$DRAFT"
--spec-type mtp
# b10018 sync: --draft-block-size/--draft-max are gone; per-round chain
# length is --spec-draft-n-max (= old block size B - 1).
--spec-draft-n-max "$(( ${DRAFT_BLOCK_SIZE:-3} - 1 ))"
--spec-draft-n-min "${DRAFT_MIN:-0}"
)
else
echo "info: speculative decoding disabled (SPEC=${SPEC}); running baseline" >&2
fi
if [[ -n "$TEMP" ]]; then
ARGS+=(--temp "$TEMP")
fi
[[ "$ENABLE_METRICS" != "0" ]] && ARGS+=(--metrics)
[[ "$ENABLE_SLOTS" != "0" ]] && ARGS+=(--slots)
[[ "$LOG_TIMESTAMPS" != "0" ]] && ARGS+=(--log-timestamps)
[[ "$LOG_PREFIX" != "0" ]] && ARGS+=(--log-prefix)
[[ "$NO_WARMUP" != "0" ]] && ARGS+=(--no-warmup)
echo "info: SPEC=${SPEC} CTX=${CTX} NGL=${NGL} FA=${FA} CTK=${CTK} CTKD=${CTKD}" >&2
echo "info: MAIN=${MAIN}" >&2
echo "info: DRAFT=${DRAFT}" >&2
exec "$SERVER" "${ARGS[@]}" "$@"