llama.cpp·ggml v1.0.0 공개: C API 버전 규칙과 업그레이드 확인 사항

ggml-org가 2026년 11월 13일 llama.cpp와 ggml의 v1.0.0을 공개했다. 공식 발표에는 공개 C API의 변경을 버전 번호에 반영하는 규칙이 담겼다. libllama를 직접 연결하거나 언어 바인딩을 관리하는 개발자라면, 새 기능과 함께 삭제된 API를 먼저 확인할 필요가 있다. 공식 발표

버전 번호가 알리는 변경 범위

공식 규칙은 ./include의 공개 C API를 기준으로 한다.

• MAJOR: 공개 C API의 호환성을 깨는 변경.
• MINOR: 이전 버전과 호환되는 기능·백엔드·모델 지원·API 추가.
• PATCH: API 변경 없이 버그를 고치는 수정.

개발팀은 llama.cpp와 ggml의 API·ABI 비호환성을 MAJOR 번호에 반영하겠다고 밝혔다. 이 규칙으로 라이브러리를 쓰는 쪽은 호환성 변경을 구분할 기준을 얻는다. 서버의 모든 동작이나 개별 실행 도구의 옵션까지 같은 범위로 보장한다고 확대해서 읽어서는 안 된다. 버전 규칙 원문

v1.0.0으로 올릴 때 확인할 API

llama.cpp 개발팀은 사용 중단을 예고한 공개 API를 삭제했다. NextN API는 정식 헤더로 옮겼다. 다음 이름과 헤더 변경을 릴리스 노트에서 확인할 수 있다.

• llama_set_warmup, deprecated 함수 35개, defrag_thold와 --defrag-thold를 삭제했다.
• NextN API를 llama-ext.h에서 llama.h로 옮겼다.
• llama_set_embd_state_src를 llama_set_ctx_state_src로 바꿨다.

기존 바인딩에 이 이름들이 남아 있다면 새 헤더와 대조해야 한다. 이는 릴리스 노트의 변경 사항을 바탕으로 한 연동 점검 권고다. 이 글에서는 실제 애플리케이션을 빌드하거나 마이그레이션을 시험하지 않았다. llama.cpp v1.0.0 릴리스

ggml 릴리스도 deprecated API와 기존 DIAG_MASK_INF·DIAG_MASK_ZERO 연산을 삭제했다고 기록했다. RPC 프로토콜은 v9로 올라갔다. RPC를 사용하는 배포라면 연결하는 구성 요소의 버전도 함께 확인할 필요가 있다. ggml v1.0.0 릴리스

업데이트 전에 남길 기록

운영 애플리케이션에서는 현재 사용하는 릴리스 태그와 빌드 설정을 먼저 기록하는 편이 좋다. 그런 다음 새 헤더에 맞춰 바인딩을 빌드하고 실제 모델로 요청을 보내 기존 동작과 비교할 수 있다. 이 절차는 이번 API 삭제에서 도출한 필자의 권고이며 프로젝트의 공식 지원 보장은 아니다.

v1.0.0이라는 번호만으로 특정 하드웨어의 추론 속도나 모델 품질을 판단할 수는 없다. 이번에 확인한 것은 공개 릴리스와 API 변경 기록이다. 성능과 호환성은 각자의 모델·백엔드·빌드 조합에서 따로 시험해야 한다.