Repolode
ikawrakow

ikawrakow/ik_llama.cpp

CPU 추론 속도에 초점을 둔 llama.cpp 포크로, 로컬에서 GGUF LLM을 실행하기 위한 추가 양자화 형식과 기능을 제공합니다.

스타
3,314
포크
494
열린 이슈
113
마지막 커밋
11시간 전

어떤 프로젝트인가요?

ik_llama.cpp는 llama.cpp의 포크로, 2024년 6월에 시작되었으며 GGUF 파일에서 대규모 언어 모델을 로컬로 실행합니다. IQK 및 Trellis 계열 등의 추가 양자화 형식을 지원하고 CPU 성능 향상을 목표로 합니다. AVX2 이상을 지원하는 x86 CPU와 ARM NEON, 그리고 CUDA를 사용하는 NVIDIA GPU(Turing 이상)에서 가장 완전한 지원을 제공합니다.

핵심 추론 엔진 외에도 DeepSeek 모델용 MLA 및 FlashMLA 어텐션, GPU 또는 CPU에 저장할 가중치를 지정하는 텐서 오버라이드, 멀티 GPU 설정을 위한 그래프 분할 모드, 여러 추측 디코딩 방식, 내장 웹 UI를 갖춘 OpenAI 호환 llama-server 등의 기능을 포함합니다. 최근 Qwen, GLM, DeepSeek, Gemma 릴리스를 비롯해 다양한 모델 아키텍처를 지원합니다.

프로젝트 측은 ROCm, Vulkan, Metal 및 구형 GPU를 적극적으로 유지 관리하지 않는다고 안내합니다. 따라서 이러한 백엔드를 사용하는 경우 의존하기 전에 문서를 확인해야 합니다.

핵심 기능

  • 01더 작고 빠른 CPU 추론을 위한 IQK 및 Trellis 양자화 형식 등의 추가 양자화 형식.
  • 02DeepSeek 모델용 MLA 및 FlashMLA 어텐션 구현.
  • 03GPU 또는 CPU에 저장할 가중치를 제어하는 텐서 오버라이드.
  • 04멀티 GPU 설정을 위한 그래프 분할 모드.
  • 05내장 웹 UI와 함수 호출을 지원하는 OpenAI 호환 llama-server.
  • 06MTP 및 n-gram 기반 방식을 포함한 추측 디코딩 옵션.

활용 사례

  • CPU 비중이 높거나 CPU/GPU를 함께 사용하는 시스템에서 양자화된 GGUF 모델 실행.
  • OpenAI 호환 API로 로컬 LLM 엔드포인트 제공.
  • VRAM이 제한된 워크스테이션에서 DeepSeek 같은 대규모 MoE 모델 실행.

빠른 시작

  1. 1

    저장소를 클론합니다

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

    CMake로 CPU용 빌드를 수행합니다

    cmake -B build -DGGML_NATIVE=ON
  3. 3

    Release 모드로 빌드를 컴파일합니다

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

    .gguf 모델 파일을 다운로드하고 서버를 시작합니다

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

사용 전 알아둘 점

  • CPU(AVX2 이상, ARM NEON) 및 CUDA(Turing 이상) 백엔드만 완전히 지원됩니다.
  • ROCm, Vulkan, Metal, 구형 Nvidia GPU 및 AVX만 지원하는 CPU는 유지 관리자가 지원하지 않습니다.
  • f16 텐서를 포함하는 일부 Unsloth _XL 모델은 작동하지 않을 수 있습니다.
  • 메인라인 llama.cpp와 모델 및 양자화 호환성이 다를 수 있습니다.

토픽

자주 묻는 질문

ik_llama.cpp은(는) 무엇인가요?
CPU 추론 속도에 초점을 둔 llama.cpp 포크로, 로컬에서 GGUF LLM을 실행하기 위한 추가 양자화 형식과 기능을 제공합니다. ik_llama.cpp는 llama.cpp의 포크로, 2024년 6월에 시작되었으며 GGUF 파일에서 대규모 언어 모델을 로컬로 실행합니다. IQK 및 Trellis 계열 등의 추가 양자화 형식을 지원하고 CPU 성능 향상을 목표로 합니다. AVX2 이상을 지원하는 x86 CPU와 ARM NEON, 그리고 CUDA를 사용하는 NVIDIA GPU(Turing 이상)에서 가장 완전한 지원을 제공합니다.
ik_llama.cpp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
ik_llama.cpp은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
ik_llama.cpp은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. ik_llama.cpp의 마지막 커밋은 2026년 10월 20일입니다.
ik_llama.cpp은(는) 어디에 사용할 수 있나요?
CPU 비중이 높거나 CPU/GPU를 함께 사용하는 시스템에서 양자화된 GGUF 모델 실행. OpenAI 호환 API로 로컬 LLM 엔드포인트 제공. VRAM이 제한된 워크스테이션에서 DeepSeek 같은 대규모 MoE 모델 실행.
ik_llama.cpp는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/ikawrakow/ik_llama.cpp CMake로 CPU용 빌드를 수행합니다: cmake -B build -DGGML_NATIVE=ON Release 모드로 빌드를 컴파일합니다: cmake --build build --config Release -j$(nproc) .gguf 모델 파일을 다운로드하고 서버를 시작합니다: ./build/bin/llama-server --model /my_local_files/gguf/Qwen_Qwen3-0.6B-IQ4_NL.gguf --ctx-size 4096
ik_llama.cpp은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ikawrakow/ik_llama.cpp

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트