Merge pull request #16 from lordmathis/fix/llama-server-options

fix: Missing or wrong llama server options
This commit is contained in:
2025-08-06 18:51:18 +02:00
committed by GitHub
4 changed files with 95 additions and 87 deletions

View File

@@ -15,12 +15,12 @@ type LlamaServerOptions struct {
CPUMask string `json:"cpu_mask,omitempty"` CPUMask string `json:"cpu_mask,omitempty"`
CPURange string `json:"cpu_range,omitempty"` CPURange string `json:"cpu_range,omitempty"`
CPUStrict int `json:"cpu_strict,omitempty"` CPUStrict int `json:"cpu_strict,omitempty"`
Priority int `json:"priority,omitempty"` Prio int `json:"prio,omitempty"`
Poll int `json:"poll,omitempty"` Poll int `json:"poll,omitempty"`
CPUMaskBatch string `json:"cpu_mask_batch,omitempty"` CPUMaskBatch string `json:"cpu_mask_batch,omitempty"`
CPURangeBatch string `json:"cpu_range_batch,omitempty"` CPURangeBatch string `json:"cpu_range_batch,omitempty"`
CPUStrictBatch int `json:"cpu_strict_batch,omitempty"` CPUStrictBatch int `json:"cpu_strict_batch,omitempty"`
PriorityBatch int `json:"priority_batch,omitempty"` PrioBatch int `json:"prio_batch,omitempty"`
PollBatch int `json:"poll_batch,omitempty"` PollBatch int `json:"poll_batch,omitempty"`
CtxSize int `json:"ctx_size,omitempty"` CtxSize int `json:"ctx_size,omitempty"`
Predict int `json:"predict,omitempty"` Predict int `json:"predict,omitempty"`
@@ -83,7 +83,7 @@ type LlamaServerOptions struct {
Seed int `json:"seed,omitempty"` Seed int `json:"seed,omitempty"`
SamplingSeq string `json:"sampling_seq,omitempty"` SamplingSeq string `json:"sampling_seq,omitempty"`
IgnoreEOS bool `json:"ignore_eos,omitempty"` IgnoreEOS bool `json:"ignore_eos,omitempty"`
Temperature float64 `json:"temperature,omitempty"` Temperature float64 `json:"temp,omitempty"`
TopK int `json:"top_k,omitempty"` TopK int `json:"top_k,omitempty"`
TopP float64 `json:"top_p,omitempty"` TopP float64 `json:"top_p,omitempty"`
MinP float64 `json:"min_p,omitempty"` MinP float64 `json:"min_p,omitempty"`
@@ -110,7 +110,7 @@ type LlamaServerOptions struct {
JSONSchema string `json:"json_schema,omitempty"` JSONSchema string `json:"json_schema,omitempty"`
JSONSchemaFile string `json:"json_schema_file,omitempty"` JSONSchemaFile string `json:"json_schema_file,omitempty"`
// Server/Example-specific params // Example-specific params
NoContextShift bool `json:"no_context_shift,omitempty"` NoContextShift bool `json:"no_context_shift,omitempty"`
Special bool `json:"special,omitempty"` Special bool `json:"special,omitempty"`
NoWarmup bool `json:"no_warmup,omitempty"` NoWarmup bool `json:"no_warmup,omitempty"`
@@ -150,17 +150,15 @@ type LlamaServerOptions struct {
NoPrefillAssistant bool `json:"no_prefill_assistant,omitempty"` NoPrefillAssistant bool `json:"no_prefill_assistant,omitempty"`
SlotPromptSimilarity float64 `json:"slot_prompt_similarity,omitempty"` SlotPromptSimilarity float64 `json:"slot_prompt_similarity,omitempty"`
LoraInitWithoutApply bool `json:"lora_init_without_apply,omitempty"` LoraInitWithoutApply bool `json:"lora_init_without_apply,omitempty"`
DraftMax int `json:"draft_max,omitempty"`
// Speculative decoding params DraftMin int `json:"draft_min,omitempty"`
DraftMax int `json:"draft_max,omitempty"` DraftPMin float64 `json:"draft_p_min,omitempty"`
DraftMin int `json:"draft_min,omitempty"` CtxSizeDraft int `json:"ctx_size_draft,omitempty"`
DraftPMin float64 `json:"draft_p_min,omitempty"` DeviceDraft string `json:"device_draft,omitempty"`
CtxSizeDraft int `json:"ctx_size_draft,omitempty"` GPULayersDraft int `json:"gpu_layers_draft,omitempty"`
DeviceDraft string `json:"device_draft,omitempty"` ModelDraft string `json:"model_draft,omitempty"`
GPULayersDraft int `json:"gpu_layers_draft,omitempty"` CacheTypeKDraft string `json:"cache_type_k_draft,omitempty"`
ModelDraft string `json:"model_draft,omitempty"` CacheTypeVDraft string `json:"cache_type_v_draft,omitempty"`
CacheTypeKDraft string `json:"cache_type_k_draft,omitempty"`
CacheTypeVDraft string `json:"cache_type_v_draft,omitempty"`
// Audio/TTS params // Audio/TTS params
ModelVocoder string `json:"model_vocoder,omitempty"` ModelVocoder string `json:"model_vocoder,omitempty"`
@@ -199,62 +197,75 @@ func (o *LlamaServerOptions) UnmarshalJSON(data []byte) error {
// Handle alternative field names // Handle alternative field names
fieldMappings := map[string]string{ fieldMappings := map[string]string{
// Official llama-server short forms from the documentation // Common params
"t": "threads", // -t, --threads N "t": "threads", // -t, --threads N
"tb": "threads_batch", // -tb, --threads-batch N "tb": "threads_batch", // -tb, --threads-batch N
"C": "cpu_mask", // -C, --cpu-mask M "C": "cpu_mask", // -C, --cpu-mask M
"Cr": "cpu_range", // -Cr, --cpu-range lo-hi "Cr": "cpu_range", // -Cr, --cpu-range lo-hi
"Cb": "cpu_mask_batch", // -Cb, --cpu-mask-batch M "Cb": "cpu_mask_batch", // -Cb, --cpu-mask-batch M
"Crb": "cpu_range_batch", // -Crb, --cpu-range-batch lo-hi "Crb": "cpu_range_batch", // -Crb, --cpu-range-batch lo-hi
"c": "ctx_size", // -c, --ctx-size N "c": "ctx_size", // -c, --ctx-size N
"n": "predict", // -n, --predict, --n-predict N "n": "predict", // -n, --predict N
"b": "batch_size", // -b, --batch-size N "n-predict": "predict", // --n-predict N
"ub": "ubatch_size", // -ub, --ubatch-size N "b": "batch_size", // -b, --batch-size N
"fa": "flash_attn", // -fa, --flash-attn "ub": "ubatch_size", // -ub, --ubatch-size N
"e": "escape", // -e, --escape "fa": "flash_attn", // -fa, --flash-attn
"dkvc": "dump_kv_cache", // -dkvc, --dump-kv-cache "e": "escape", // -e, --escape
"nkvo": "no_kv_offload", // -nkvo, --no-kv-offload "dkvc": "dump_kv_cache", // -dkvc, --dump-kv-cache
"ctk": "cache_type_k", // -ctk, --cache-type-k TYPE "nkvo": "no_kv_offload", // -nkvo, --no-kv-offload
"ctv": "cache_type_v", // -ctv, --cache-type-v TYPE "ctk": "cache_type_k", // -ctk, --cache-type-k TYPE
"dt": "defrag_thold", // -dt, --defrag-thold N "ctv": "cache_type_v", // -ctv, --cache-type-v TYPE
"np": "parallel", // -np, --parallel N "dt": "defrag_thold", // -dt, --defrag-thold N
"dev": "device", // -dev, --device <dev1,dev2,..> "np": "parallel", // -np, --parallel N
"ot": "override_tensor", // --override-tensor, -ot "dev": "device", // -dev, --device <dev1,dev2,..>
"ngl": "gpu_layers", // -ngl, --gpu-layers, --n-gpu-layers N "ot": "override_tensor", // --override-tensor, -ot
"sm": "split_mode", // -sm, --split-mode "ngl": "gpu_layers", // -ngl, --gpu-layers, --n-gpu-layers N
"ts": "tensor_split", // -ts, --tensor-split N0,N1,N2,... "n-gpu-layers": "gpu_layers", // --n-gpu-layers N
"mg": "main_gpu", // -mg, --main-gpu INDEX "sm": "split_mode", // -sm, --split-mode
"m": "model", // -m, --model FNAME "ts": "tensor_split", // -ts, --tensor-split N0,N1,N2,...
"mu": "model_url", // -mu, --model-url MODEL_URL "mg": "main_gpu", // -mg, --main-gpu INDEX
"hf": "hf_repo", // -hf, -hfr, --hf-repo "m": "model", // -m, --model FNAME
"hfr": "hf_repo", // -hf, -hfr, --hf-repo "mu": "model_url", // -mu, --model-url MODEL_URL
"hfd": "hf_repo_draft", // -hfd, -hfrd, --hf-repo-draft "hf": "hf_repo", // -hf, -hfr, --hf-repo
"hfrd": "hf_repo_draft", // -hfd, -hfrd, --hf-repo-draft "hfr": "hf_repo", // -hf, -hfr, --hf-repo
"hff": "hf_file", // -hff, --hf-file FILE "hfd": "hf_repo_draft", // -hfd, -hfrd, --hf-repo-draft
"hfv": "hf_repo_v", // -hfv, -hfrv, --hf-repo-v "hfrd": "hf_repo_draft", // -hfd, -hfrd, --hf-repo-draft
"hfrv": "hf_repo_v", // -hfv, -hfrv, --hf-repo-v "hff": "hf_file", // -hff, --hf-file FILE
"hffv": "hf_file_v", // -hffv, --hf-file-v FILE "hfv": "hf_repo_v", // -hfv, -hfrv, --hf-repo-v
"hft": "hf_token", // -hft, --hf-token TOKEN "hfrv": "hf_repo_v", // -hfv, -hfrv, --hf-repo-v
"v": "verbose", // -v, --verbose, --log-verbose "hffv": "hf_file_v", // -hffv, --hf-file-v FILE
"lv": "verbosity", // -lv, --verbosity, --log-verbosity N "hft": "hf_token", // -hft, --hf-token TOKEN
"s": "seed", // -s, --seed SEED "v": "verbose", // -v, --verbose, --log-verbose
"temp": "temperature", // --temp N "log-verbose": "verbose", // --log-verbose
"l": "logit_bias", // -l, --logit-bias "lv": "verbosity", // -lv, --verbosity, --log-verbosity N
"j": "json_schema", // -j, --json-schema SCHEMA "log-verbosity": "verbosity", // --log-verbosity N
"jf": "json_schema_file", // -jf, --json-schema-file FILE
"sp": "special", // -sp, --special // Sampling params
"cb": "cont_batching", // -cb, --cont-batching "s": "seed", // -s, --seed SEED
"nocb": "no_cont_batching", // -nocb, --no-cont-batching "l": "logit_bias", // -l, --logit-bias
"a": "alias", // -a, --alias STRING "j": "json_schema", // -j, --json-schema SCHEMA
"to": "timeout", // -to, --timeout N "jf": "json_schema_file", // -jf, --json-schema-file FILE
"sps": "slot_prompt_similarity", // -sps, --slot-prompt-similarity
"cd": "ctx_size_draft", // -cd, --ctx-size-draft N // Example-specific params
"devd": "device_draft", // -devd, --device-draft "sp": "special", // -sp, --special
"ngld": "gpu_layers_draft", // -ngld, --gpu-layers-draft "cb": "cont_batching", // -cb, --cont-batching
"md": "model_draft", // -md, --model-draft FNAME "nocb": "no_cont_batching", // -nocb, --no-cont-batching
"ctkd": "cache_type_k_draft", // -ctkd, --cache-type-k-draft TYPE "a": "alias", // -a, --alias STRING
"ctvd": "cache_type_v_draft", // -ctvd, --cache-type-v-draft TYPE "embeddings": "embedding", // --embeddings
"mv": "model_vocoder", // -mv, --model-vocoder FNAME "rerank": "reranking", // --reranking
"to": "timeout", // -to, --timeout N
"sps": "slot_prompt_similarity", // -sps, --slot-prompt-similarity
"draft": "draft-max", // -draft, --draft-max N
"draft-n": "draft-max", // --draft-n-max N
"draft-n-min": "draft_min", // --draft-n-min N
"cd": "ctx_size_draft", // -cd, --ctx-size-draft N
"devd": "device_draft", // -devd, --device-draft
"ngld": "gpu_layers_draft", // -ngld, --gpu-layers-draft
"n-gpu-layers-draft": "gpu_layers_draft", // --n-gpu-layers-draft N
"md": "model_draft", // -md, --model-draft FNAME
"ctkd": "cache_type_k_draft", // -ctkd, --cache-type-k-draft TYPE
"ctvd": "cache_type_v_draft", // -ctvd, --cache-type-v-draft TYPE
"mv": "model_vocoder", // -mv, --model-vocoder FNAME
} }
// Process alternative field names // Process alternative field names

View File

@@ -109,13 +109,13 @@ func TestBuildCommandArgs_NumericFields(t *testing.T) {
args := options.BuildCommandArgs() args := options.BuildCommandArgs()
expectedPairs := map[string]string{ expectedPairs := map[string]string{
"--port": "8080", "--port": "8080",
"--threads": "4", "--threads": "4",
"--ctx-size": "2048", "--ctx-size": "2048",
"--gpu-layers": "16", "--gpu-layers": "16",
"--temperature": "0.7", "--temp": "0.7",
"--top-k": "40", "--top-k": "40",
"--top-p": "0.9", "--top-p": "0.9",
} }
for flag, expectedValue := range expectedPairs { for flag, expectedValue := range expectedPairs {
@@ -231,7 +231,7 @@ func TestUnmarshalJSON_StandardFields(t *testing.T) {
"verbose": true, "verbose": true,
"ctx_size": 4096, "ctx_size": 4096,
"gpu_layers": 32, "gpu_layers": 32,
"temperature": 0.7 "temp": 0.7
}` }`
var options llamacpp.LlamaServerOptions var options llamacpp.LlamaServerOptions

View File

@@ -1,5 +1,4 @@
import type { CreateInstanceOptions} from '@/schemas/instanceOptions'; import { type CreateInstanceOptions, getAllFieldKeys } from '@/schemas/instanceOptions'
import { getAllFieldKeys } from '@/schemas/instanceOptions'
// Only define the basic fields we want to show by default // Only define the basic fields we want to show by default
export const basicFieldsConfig: Record<string, { export const basicFieldsConfig: Record<string, {

View File

@@ -14,12 +14,12 @@ export const CreateInstanceOptionsSchema = z.object({
cpu_mask: z.string().optional(), cpu_mask: z.string().optional(),
cpu_range: z.string().optional(), cpu_range: z.string().optional(),
cpu_strict: z.number().optional(), cpu_strict: z.number().optional(),
priority: z.number().optional(), prio: z.number().optional(),
poll: z.number().optional(), poll: z.number().optional(),
cpu_mask_batch: z.string().optional(), cpu_mask_batch: z.string().optional(),
cpu_range_batch: z.string().optional(), cpu_range_batch: z.string().optional(),
cpu_strict_batch: z.number().optional(), cpu_strict_batch: z.number().optional(),
priority_batch: z.number().optional(), prio_batch: z.number().optional(),
poll_batch: z.number().optional(), poll_batch: z.number().optional(),
ctx_size: z.number().optional(), ctx_size: z.number().optional(),
predict: z.number().optional(), predict: z.number().optional(),
@@ -82,7 +82,7 @@ export const CreateInstanceOptionsSchema = z.object({
seed: z.number().optional(), seed: z.number().optional(),
sampling_seq: z.string().optional(), sampling_seq: z.string().optional(),
ignore_eos: z.boolean().optional(), ignore_eos: z.boolean().optional(),
temperature: z.number().optional(), temp: z.number().optional(),
top_k: z.number().optional(), top_k: z.number().optional(),
top_p: z.number().optional(), top_p: z.number().optional(),
min_p: z.number().optional(), min_p: z.number().optional(),
@@ -109,7 +109,7 @@ export const CreateInstanceOptionsSchema = z.object({
json_schema: z.string().optional(), json_schema: z.string().optional(),
json_schema_file: z.string().optional(), json_schema_file: z.string().optional(),
// Server/Example-specific params // Example-specific params
no_context_shift: z.boolean().optional(), no_context_shift: z.boolean().optional(),
special: z.boolean().optional(), special: z.boolean().optional(),
no_warmup: z.boolean().optional(), no_warmup: z.boolean().optional(),
@@ -149,8 +149,6 @@ export const CreateInstanceOptionsSchema = z.object({
no_prefill_assistant: z.boolean().optional(), no_prefill_assistant: z.boolean().optional(),
slot_prompt_similarity: z.number().optional(), slot_prompt_similarity: z.number().optional(),
lora_init_without_apply: z.boolean().optional(), lora_init_without_apply: z.boolean().optional(),
// Speculative decoding params
draft_max: z.number().optional(), draft_max: z.number().optional(),
draft_min: z.number().optional(), draft_min: z.number().optional(),
draft_p_min: z.number().optional(), draft_p_min: z.number().optional(),