llama-cpp

llama.cpp local GGUF inference + HF Hub model discovery.

  • llama.cpp
  • GGUF
  • Quantization
  • Hugging Face Hub
  • CPU Inference
  • Apple Silicon
  • Edge Deployment
  • AMD GPUs
  • Intel GPUs
  • NVIDIA
  • URL-first

Declared platforms: linux · macos · windows

Install
npx skills add 'https://github.com/NousResearch/hermes-agent/tree/main/optional-skills/mlops/inference/llama-cpp'
Download bundle ↓
main · 24fd22bScanned 2026-09-15

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗
View on GitHub
← Back to SKILL.md

Performance Optimization Guide

Maximize llama.cpp inference speed and efficiency.

CPU Optimization

Thread tuning

# Set threads (default: physical cores)
./llama-cli -m model.gguf -t 8

# For AMD Ryzen 9 7950X (16 cores, 32 threads)
-t 16  # Best: physical cores

# Avoid hyperthreading (slower for matrix ops)

BLAS acceleration

# OpenBLAS (faster matrix ops)
make LLAMA_OPENBLAS=1

# BLAS gives 2-3× speedup

GPU Offloading

Layer offloading

# Offload 35 layers to GPU (hybrid mode)
./llama-cli -m model.gguf -ngl 35

# Offload all layers
./llama-cli -m model.gguf -ngl 999

# Find optimal value:
# Start with -ngl 999
# If OOM, reduce by 5 until fits

Memory usage

# Check VRAM usage
nvidia-smi dmon

# Reduce context if needed
./llama-cli -m model.gguf -c 2048  # 2K context instead of 4K

Batch Processing

# Increase batch size for throughput
./llama-cli -m model.gguf -b 512  # Default: 512

# Physical batch (GPU)
--ubatch 128  # Process 128 tokens at once

Context Management

# Default context (512 tokens)
-c 512

# Longer context (slower, more memory)
-c 4096

# Very long context (if model supports)
-c 32768

Benchmarks

CPU Performance (Llama 2-7B Q4_K_M)

SetupSpeedNotes
Apple M3 Max50 tok/sMetal acceleration
AMD 7950X (16c)35 tok/sOpenBLAS
Intel i9-13900K30 tok/sAVX2

GPU Offloading (RTX 4090)

Layers GPUSpeedVRAM
0 (CPU only)30 tok/s0 GB
20 (hybrid)80 tok/s8 GB
35 (all)120 tok/s12 GB
Referenced from SKILL.md