Llama Cpp

llama.cpp

Inferência de LLM pura em C/C++ com dependências mínimas, otimizada para CPUs e hardware não-NVIDIA.

Quando usar llama.cpp

Use llama.cpp quando:

• Executar em máquinas apenas com CPU
• Fazer deploy em Apple Silicon (M1/M2/M3/M4)
• Usar GPUs AMD ou Intel (sem CUDA)
• Edge deployment (Raspberry Pi, sistemas embarcados)
• Precisar de deploy simples sem Docker/Python

Use TensorRT-LLM quando:

• Tiver GPUs NVIDIA (A100/H100)
• Precisar de throughput máximo (100K+ tok/s)
• Rodando em datacenter com CUDA

Use vLLM quando:

• Tiver GPUs NVIDIA
• Precisar de API Python-first
• Quiser PagedAttention

Guia rápido

Instalação

# macOS/Linux
brew install llama.cpp

# Ou compilar do source
git clone https://github.com/ggerganov/llama.cpp
cd llama.cpp
make

# Com Metal (Apple Silicon)
make LLAMA_METAL=1

# Com CUDA (NVIDIA)
make LLAMA_CUDA=1

# Com ROCm (AMD)
make LLAMA_HIP=1

Baixar modelo

# Baixar do HuggingFace (formato GGUF)
huggingface-cli download \
    TheBloke/Llama-2-7B-Chat-GGUF \
    llama-2-7b-chat.Q4_K_M.gguf \
    --local-dir models/

# Ou converter do HuggingFace
python convert_hf_to_gguf.py models/llama-2-7b-chat/

Executar inferência

# Chat simples
./llama-cli \
    -m models/llama-2-7b-chat.Q4_K_M.gguf \
    -p "Explain quantum computing" \
    -n 256  # Max tokens

# Chat interativo
./llama-cli \
    -m models/llama-2-7b-chat.Q4_K_M.gguf \
    --interactive

Modo server

# Iniciar servidor compatível com OpenAI
./llama-server \
    -m models/llama-2-7b-chat.Q4_K_M.gguf \
    --host 0.0.0.0 \
    --port 8080 \
    -ngl 32  # Offload 32 layers to GPU

# Requisição do cliente
curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama-2-7b-chat",
    "messages": [{"role": "user", "content": "Hello!"}],
    "temperature": 0.7,
    "max_tokens": 100
  }'

Formatos de quantização

Visão geral do formato GGUF

Escolhendo quantização

# Uso geral (equilibrado)
Q4_K_M  # 4-bit, qualidade média

# Velocidade máxima (mais degradação)
Q2_K or Q3_K_M

# Qualidade máxima (mais lento)
Q6_K or Q8_0

# Modelos muito grandes (70B, 405B)
Q3_K_M or Q4_K_S  # Bits menores para caber na memória

Aceleração de hardware

Apple Silicon (Metal)

# Compilar com Metal
make LLAMA_METAL=1

# Executar com aceleração GPU (automático)
./llama-cli -m model.gguf -ngl 999  # Offload all layers

# Performance: M3 Max 40-60 tokens/sec (Llama 2-7B Q4_K_M)

GPUs NVIDIA (CUDA)

# Compilar com CUDA
make LLAMA_CUDA=1

# Offload layers para GPU
./llama-cli -m model.gguf -ngl 35  # Offload 35/40 layers

# Híbrido CPU+GPU para modelos grandes
./llama-cli -m llama-70b.Q4_K_M.gguf -ngl 20  # GPU: 20 layers, CPU: rest

GPUs AMD (ROCm)

# Compilar com ROCm
make LLAMA_HIP=1

# Executar com GPU AMD
./llama-cli -m model.gguf -ngl 999

Padrões comuns

Processamento em lote

# Processar múltiplos prompts de arquivo
cat prompts.txt | ./llama-cli \
    -m model.gguf \
    --batch-size 512 \
    -n 100

Geração restrita

# Saída JSON com grammar
./llama-cli \
    -m model.gguf \
    -p "Generate a person: " \
    --grammar-file grammars/json.gbnf

# Outputs valid JSON only

Tamanho de contexto

# Aumentar contexto (padrão 512)
./llama-cli \
    -m model.gguf \
    -c 4096  # 4K context window

# Contexto muito longo (se modelo suportar)
./llama-cli -m model.gguf -c 32768  # 32K context

Benchmarks de performance

Performance em CPU (Llama 2-7B Q4_K_M)

Aceleração por GPU (Llama 2-7B Q4_K_M)

Modelos suportados

Família LLaMA:

• Llama 2 (7B, 13B, 70B)
• Llama 3 (8B, 70B, 405B)
• Code Llama

Família Mistral:

• Mistral 7B
• Mixtral 8x7B, 8x22B

Outros:

• Falcon, BLOOM, GPT-J
• Phi-3, Gemma, Qwen
• LLaVA (vision), Whisper (audio)

Encontrar modelos: https://huggingface.co/models?library=gguf

Referências

• Guia de Quantização - Formatos GGUF, conversão, comparação de qualidade
• Deploy de Server - Endpoints de API, Docker, monitoramento
• Otimização - Ajuste de performance, CPU+GPU híbrido

Recursos

• GitHub: https://github.com/ggerganov/llama.cpp
• Modelos: https://huggingface.co/models?library=gguf
• Discord: https://discord.gg/llama-cpp