community-scripts / community-scripts/ProxmoxVED
llama-cpp
Nobody has claimed this yet.
- Dominant language
- Shell
- Stars
- 191
- Forks
- 497
- Avg merge
- 3d 5h
- Merged PRs (30d)
- 33
Description
Name of the Script
llama-cpp
Script Type
CT (LXC Container)
Does this script support arm64?
arm64 supported
📋 Script Details
llama.cpp runs GGUF models in C/C++ with no Python runtime. llama-server serves a built-in web chat UI and an OpenAI-compatible API on the same port, so it can back AnythingLLM (#2120), Open WebUI or Claude Code. Lighter than the existing ollama script.
- No compiling:
prebuildmode againstllama-*-bin-ubuntu-$(arch_resolve x64 arm64).tar.gzfrom the daily release line (currentlyb10240). Binaries sit flat in the archive, soLD_LIBRARY_PATH=/opt/llama-cppis set in the unit for the bundled.sofiles. - Usable out of the box: configured through
LLAMA_ARG_*env vars, which map 1:1 to the CLI flags.LLAMA_ARG_HF_REPOmakes llama-server pull a model from Hugging Face on first start (defaultggml-org/gemma-3-1b-it-GGUF, ~800 MB) into/opt/llama-cpp_data/modelsviaLLAMA_CACHE. No manual model juggling before the first launch, andLLAMA_ARG_MODELstill works for local files. var_gpu="yes"— the release also ships vulkan, rocm and sycl variants; the script installs the CPU build withLLAMA_ARG_N_GPU_LAYERS=0and documents the switch.- Note: no authentication by default.
LLAMA_ARG_API_KEYis mentioned in the JSON notes as the fix.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by comparing the existing ollama script with the proposed llama-cpp CT script and the llama.cpp release archive named in the issue. Verify the llama-server entry point, LLAMA_ARG_* configuration, arm64 archive selection, model cache path, and LD_LIBRARY_PATH handling. Done means the CPU-based script installs and starts with the documented model defaults, while its GPU and API-key options are documented.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- cpp, shell
- Domain
- ai, devops, infrastructure
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 55/100