Provide an optimized systemd service template with dynamic per-model GGUF optimization
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 35/100
- Issue 类型
- 功能
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- bash
- 领域
- devops
调研方向
The proposal is a systemd unit whose ExecStartPre bash script generates a preset .ini for llama-server --models-preset; check the repo's server docs and examples to confirm the preset keys and flags it uses. Before any file is added, the maintainer needs to agree on whether this belongs in the examples folder, and the script's gguf-parser/jq field names and cache-type choices need verifying. Done means a reviewed unit file and a README note that run cleanly on a sample models directory.
由索引模型根据 Issue 内容生成。
描述
Prerequisites
- I am running the latest code. Mention the version if possible as well.
- I carefully followed the README.md.
- I searched using keywords relevant to my issue to make sure that I am creating a new issue that is not already open (or closed).
- I reviewed the Discussions, and have a new and useful enhancement to share.
Feature Description
Hello! I would like to share and propose a production-ready systemd service file for beellama.cpp that automatically generates optimal presets and handles dynamic per-model configurations at startup.
This configuration uses gguf-parser and jq to parse local models dynamically, matching them with multimodal projectors (mmproj) and configuring layers, context sizes, and KV cache types automatically.
Features of this Systemd Unit:
Inline Dynamic Preset Generation: Automatically scans the models directory before starting the server and writes an optimized configuration file (beellama_auto.ini).
Smart Architecture Detection: Extracts block counts (gpu-layers), maximum context lengths, and architecture types using gguf-parser and jq.
Automatic Multimodal Mapping: Automatically detects and pairs mmproj files with their corresponding base models based on filename matching.
LoRA & KV Cache Tuning: Automatically adjusts cache types (e.g., switches to q4_0 if LoRA ranks are detected, otherwise uses kvarn4).
Proposed Systemd Unit File:
[Unit]
Description=beellama.cpp Server with Dynamic Per-Model Optimization
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
Environment="MODELS_DIR=/run/media/user/Data/LLM"
Environment="PRESET_FILE=/etc/conf.d/beellama_auto.ini"
ExecStartPre=/bin/bash -c ' \
set -Eeuo pipefail; \
echo "=== beellama: inline dynamic preset generator ==="; \
echo "# Auto-generated optimal preset" > "$PRESET_FILE"; \
echo "" >> "$PRESET_FILE"; \
echo "[*]" >> "$PRESET_FILE"; \
echo "threads = 8" >> "$PRESET_FILE"; \
echo "threads-batch = 8" >> "$PRESET_FILE"; \
echo "flash-attn = on" >> "$PRESET_FILE"; \
echo "" >> "$PRESET_FILE"; \
while IFS= read -r -d "" MODEL_FILE; do \
MODEL_NAME=$(basename "$MODEL_FILE" .gguf); \
MODEL_DIR=$(dirname "$MODEL_FILE"); \
MMPROJ_FILE=""; \
CANDIDATE=$(find "$MODEL_DIR" -type f -iname "*mmproj*.gguf" -print -quit || true); \
if [ -n "$CANDIDATE" ]; then \
CLEAN_MODEL_NAME=$(echo "$MODEL_NAME" | sed "s/-Q[0-9].*//i" | sed "s/-IQ.*//i"); \
if echo "$CANDIDATE" | grep -qi "$CLEAN_MODEL_NAME"; then \
MMPROJ_FILE="$CANDIDATE"; \
fi; \
fi; \
LAYERS="auto"; \
CTX_SIZE="32768"; \
CACHE_TYPE="kvarn4"; \
ARCH_DETECTED="unknown"; \
if command -v gguf-parser >/dev/null 2>&1 && command -v jq >/dev/null 2>&1; then \
JSON_OUT=$(gguf-parser --model "$MODEL_FILE" --json 2>/dev/null || true); \
if [ -n "$JSON_OUT" ]; then \
DETECTED_LAYERS=$(echo "$JSON_OUT" | jq -r ".architecture.blockCount // empty" 2>/dev/null || true); \
if [ -n "$DETECTED_LAYERS" ] && [ "$DETECTED_LAYERS" != "null" ]; then \
LAYERS="$DETECTED_LAYERS"; \
fi; \
DETECTED_CTX=$(echo "$JSON_OUT" | jq -r ".architecture.maximumContextLength // empty" 2>/dev/null || true); \
if [ -n "$DETECTED_CTX" ] && [ "$DETECTED_CTX" != "null" ]; then \
if [ "$DETECTED_CTX" -lt 32768 ]; then \
CTX_SIZE="$DETECTED_CTX"; \
else \
CTX_SIZE="32768"; \
fi; \
fi; \
ARCH_DETECTED=$(echo "$JSON_OUT" | jq -r ".architecture.architecture // \"unknown\"" 2>/dev/null || true); \
LORARANK=$(echo "$JSON_OUT" | jq -r ".architecture.attentionKeyValueLORARank // 0" 2>/dev/null || true); \
if [ "$LORARANK" -gt 0 ] 2>/dev/null; then \
CACHE_TYPE="q4_0"; \
fi; \
fi; \
fi; \
echo "Model: $MODEL_NAME [Arch: $ARCH_DETECTED] -> Layers: $LAYERS, Ctx: $CTX_SIZE, Cache: $CACHE_TYPE"; \
echo "[$MODEL_NAME]" >> "$PRESET_FILE"; \
echo "model = $MODEL_FILE" >> "$PRESET_FILE"; \
echo "gpu-layers = $LAYERS" >> "$PRESET_FILE"; \
echo "ctx-size = $CTX_SIZE" >> "$PRESET_FILE"; \
echo "cache-type-k = $CACHE_TYPE" >> "$PRESET_FILE"; \
echo "cache-type-v = $CACHE_TYPE" >> "$PRESET_FILE"; \
if [ -n "$MMPROJ_FILE" ]; then \
echo "mmproj = $MMPROJ_FILE" >> "$PRESET_FILE"; \
fi; \
echo "" >> "$PRESET_FILE"; \
done < <(find "$MODELS_DIR" -type f -name "*.gguf" ! -iname "*mmproj*" -print0); \
echo "Preset generation complete."'
ExecStart=/usr/bin/llama-server --models-preset /etc/conf.d/beellama_auto.ini --host 0.0.0.0 --port 8080 --models-max 1 --cache-reuse 1024 --cache-ram 16384
ExecReload=/bin/kill -s HUP $MAINPID
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
Feel free to adapt or integrate this into the documentation or examples folder if others might find it useful!
Motivation
Key benefits for users:
- Zero-Touch Configuration: Automatically scans the designated models directory, eliminating the need to manually write or update .ini preset files whenever new models are added or removed.
- Smart Resource Optimization: Leverages gguf-parser and jq to dynamically extract hardware-friendly metrics per model (such as exact architecture block counts for optimal GPU layer offloading and context limits).
- Seamless Multimodal Support: Automatically detects and pairs mmproj files with their respective base models based on filename structure.
- Production Reliability: Standardizes deployment using standard systemd patterns (Restart=on-failure, graceful HUP reloading, and proper environment separation) making it ideal for self-hosted LLM setups.
Possible Implementation
No response
- 主要语言
- C++
- 星标
- 1.2k
- 派生
- 80
- 平均合并
- 4 天 20 小时
- 30 天内合并 PR
- 2
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
Anbeeld/beellama.cpp 的其他 Issue
-
[BUG] KVarN assertion failure in build_inp_mem_hybrid_iswa() due to uninitialized self_kvarn_rot未关闭
难度 2/5 1-3 小时 新手友好度 68/100
Anbeeld/beellama.cpp#205 ·
-
难度 3/5 半天 新手友好度 58/100
Anbeeld/beellama.cpp#206 ·
-
难度 3/5 1-2 天 新手友好度 57/100
Anbeeld/beellama.cpp#204 ·
-
难度 4/5 3-5 天 新手友好度 45/100
Anbeeld/beellama.cpp#203 · 2 条评论 ·
-
难度 4/5 3-5 天 新手友好度 45/100
Anbeeld/beellama.cpp#202 · 1 条评论 ·
查看 Anbeeld/beellama.cpp 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 72/100
CachyOS/packageinstaller#144 ·
维护者通常 1 天内回复
-
documentation
难度 1/5 1 小时以内 新手友好度 82/100
TomerAberbach/profiler-md#951 ·
维护者通常 1 天内回复
-
[Bug] Default key routing (JavaStringHash) picks a different partition than the Java client for about half of keys可能已有人在做 @0z5a 今天认领。 未关闭
难度 2/5 1-3 小时 新手友好度 82/100
apache/pulsar-client-go#1575 ·
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
pocoproject/poco#5764 ·
维护者通常 2 天内回复
-
bug cpp-core-guidelines low-priority
难度 2/5 1-3 小时 新手友好度 62/100
NatronGitHub/openfx-supportext#164 ·
维护者通常 1 天内回复