Repolode
ikawrakow

ikawrakow/ik_llama.cpp

Fork do llama.cpp focado em acelerar a inferência em CPU, com tipos extras de quantização e recursos para executar LLMs GGUF localmente.

Estrelas
3,314
Forks
494
Issues abertas
113
Último commit
há 5 horas

O que é?

ik_llama.cpp é um fork do llama.cpp, iniciado em junho de 2024, que executa modelos de linguagem grandes localmente a partir de arquivos GGUF. Ele adiciona tipos de quantização, como as famílias IQK e Trellis, e busca oferecer melhor desempenho em CPU, com suporte mais completo em CPUs x86 com AVX2 ou mais recente e ARM NEON, além de GPUs NVIDIA com CUDA (Turing ou mais recente).

Além do mecanismo de inferência principal, o fork inclui recursos como atenção MLA e FlashMLA para modelos DeepSeek, substituições de tensores para definir quais pesos ficam na GPU ou na CPU, um modo de divisão de grafo para configurações com várias GPUs, variantes de decodificação especulativa e um llama-server compatível com OpenAI, com interface web integrada. Há suporte a muitas arquiteturas de modelos, incluindo versões recentes de Qwen, GLM, DeepSeek e Gemma.

O projeto informa que ROCm, Vulkan, Metal e GPUs mais antigas não são mantidos ativamente; por isso, quem usa esses backends deve consultar a documentação antes de depender deles.

Recursos principais

  • 01Tipos adicionais de quantização, como IQK e Trellis, para inferência em CPU mais rápida e com menor uso de memória.
  • 02Implementações de atenção MLA e FlashMLA para modelos DeepSeek.
  • 03Substituições de tensores para controlar quais pesos são armazenados na GPU ou na CPU.
  • 04Modo de divisão de grafo para configurações com várias GPUs.
  • 05llama-server compatível com OpenAI, com interface web integrada e suporte a chamadas de função.
  • 06Opções de decodificação especulativa, incluindo MTP e métodos baseados em n-gramas.

Casos de uso

  • Executar modelos GGUF quantizados em máquinas com foco em CPU ou com CPU e GPU combinadas.
  • Disponibilizar endpoints locais de LLM com uma API compatível com OpenAI.
  • Executar modelos MoE grandes, como DeepSeek, em uma workstation com VRAM limitada.

Início rápido

  1. 1

    Clone o repositório

    git clone https://github.com/ikawrakow/ik_llama.cpp
  2. 2

    Compile para CPU com CMake

    cmake -B build -DGGML_NATIVE=ON
  3. 3

    Compile o projeto no modo Release

    cmake --build build --config Release -j$(nproc)
  4. 4

    Baixe um arquivo de modelo .gguf e inicie o servidor

    ./build/bin/llama-server --model /my_local_files/gguf/Qwen_Qwen3-0.6B-IQ4_NL.gguf --ctx-size 4096

Antes de usar

  • Somente os backends de CPU (AVX2 ou superior, ARM NEON) e CUDA (Turing ou mais recente) têm suporte completo.
  • ROCm, Vulkan, Metal, GPUs Nvidia antigas e CPUs compatíveis apenas com AVX não têm suporte dos mantenedores.
  • Alguns modelos Unsloth _XL com tensores f16 podem não funcionar.
  • A compatibilidade com modelos e quantização pode ser diferente da versão principal do llama.cpp.

Tópicos

Perguntas frequentes

O que é ik_llama.cpp?
Fork do llama.cpp focado em acelerar a inferência em CPU, com tipos extras de quantização e recursos para executar LLMs GGUF localmente. ik_llama.cpp é um fork do llama.cpp, iniciado em junho de 2024, que executa modelos de linguagem grandes localmente a partir de arquivos GGUF. Ele adiciona tipos de quantização, como as famílias IQK e Trellis, e busca oferecer melhor desempenho em CPU, com suporte mais completo em CPUs x86 com AVX2 ou mais recente e ARM NEON, além de GPUs NVIDIA com CUDA (Turing ou mais recente).
ik_llama.cpp é gratuito? Qual é a licença?
ik_llama.cpp é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ik_llama.cpp ainda é mantido?
Manutenção ativa. O último commit de ik_llama.cpp foi em 20 de out. de 2026.
Para que posso usar ik_llama.cpp?
Executar modelos GGUF quantizados em máquinas com foco em CPU ou com CPU e GPU combinadas. Disponibilizar endpoints locais de LLM com uma API compatível com OpenAI. Executar modelos MoE grandes, como DeepSeek, em uma workstation com VRAM limitada.
Como instalar ik_llama.cpp?
Clone o repositório: git clone https://github.com/ikawrakow/ik_llama.cpp Compile para CPU com CMake: cmake -B build -DGGML_NATIVE=ON Compile o projeto no modo Release: cmake --build build --config Release -j$(nproc) Baixe um arquivo de modelo .gguf e inicie o servidor: ./build/bin/llama-server --model /my_local_files/gguf/Qwen_Qwen3-0.6B-IQ4_NL.gguf --ctx-size 4096
Onde consigo ik_llama.cpp?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ikawrakow/ik_llama.cpp

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados