Bindings: Add llama.cpp dev options to build guide

Also change LLAMACPP_TAG to LLAMACPP_COMMIT

Signed-off-by: kingbri <8082010+kingbri1@users.noreply.github.com>

Author: kingbri1

BUILDING.md

@@ -43,6 +43,8 @@ This will invoke CMake to build the bindings and copy the resulting shared libra
 
 Optionally, environment variables can be set for certain architectures when building (ex. CUDA):
 - `MAX_JOBS`: Number of parallel jobs (defaults to the number of CPU cores)
+- `LLAMACPP_REPO`: Point to a custom repository for llama.cpp (Here be dragons!)
+- `LLAMACPP_TAG`: Set a specific tag for llama.cpp (Here be dragons!)
 - `GGML_CUDA=1`: Enables CUDA support
 - `CMAKE_CUDA_ARCHITECTURES`: Specifies CUDA compute capabilities (defaults to `native` if using CMake > 3.24)
 - `GGML_VULKAN=1`: Enables Vulkan Support

bindings/CMakeLists.txt

@@ -13,13 +13,15 @@ elseif (UNIX)
     set(CMAKE_INSTALL_RPATH_USE_LINK_PATH FALSE)
 endif()
 
-# Stable llama.cpp commit for bindings
-set(LLAMACPP_COMMIT "84d547554123a62e9ac77107cb20e4f6cc503af4")
+if (DEFINED LLAMACPP_REPO OR DEFINED LLAMACPP_COMMIT)
+    message(STATUS "Using a custom commit or repo for llama.cpp. Build might not work as expected. Here be dragons!")
+endif()
 
 set(LLAMACPP_REPO "https://github.com/ggerganov/llama.cpp.git" CACHE STRING "llama.cpp repository URL")
 message(STATUS "Using llama.cpp repo ${LLAMACPP_REPO}")
 
-set(LLAMACPP_TAG ${LLAMACPP_COMMIT} CACHE STRING "llama.cpp repository tag")
+# Stable llama.cpp commit for bindings
+set(LLAMACPP_COMMIT "84d547554123a62e9ac77107cb20e4f6cc503af4" CACHE STRING "llama.cpp repository commit")
 message(STATUS "Using llama.cpp tag ${LLAMACPP_COMMIT}")
 
 # Fetch llama.cpp latest
@@ -28,7 +30,7 @@ include(FetchContent)
 FetchContent_Declare(
     llama
     GIT_REPOSITORY ${LLAMACPP_REPO}
-    GIT_TAG ${LLAMACPP_TAG}
+    GIT_TAG ${LLAMACPP_COMMIT}
 )
 
 # Required for proper builds

bindings/bindings.ps1

@@ -19,9 +19,9 @@ if ($env:LLAMACPP_REPO) {
     Write-Host "Using custom llama.cpp repo: $env:LLAMACPP_REPO"
 }
 
-if ($env:LLAMACPP_TAG) {
-    $extraCmakeArgs += "-DLLAMACPP_REPO=$env:LLAMACPP_TAG"
-    Write-Host "Using custom llama.cpp tag: $env:LLAMACPP_TAG"
+if ($env:LLAMACPP_COMMIT) {
+    $extraCmakeArgs += "-DLLAMACPP_COMMIT=$env:LLAMACPP_COMMIT"
+    Write-Host "Using custom llama.cpp commit: $env:LLAMACPP_COMMIT"
 }
 
 if ($env:GGML_CUDA -eq 1) {

bindings/bindings.sh

@@ -20,9 +20,9 @@ if [ -n "$LLAMACPP_REPO" ]; then
     echo "Using custom llama.cpp repo: ${LLAMACPP_REPO}"
 fi
 
-if [ -n "$LLAMACPP_TAG" ]; then
-    EXTRA_CMAKE_ARGS+=("-DLLAMACPP_TAG=$LLAMACPP_TAG")
-    echo "Using custom llama.cpp tag: ${LLAMACPP_TAG}"
+if [ -n "$LLAMACPP_COMMIT" ]; then
+    EXTRA_CMAKE_ARGS+=("-DLLAMACPP_COMMIT=$LLAMACPP_COMMIT")
+    echo "Using custom llama.cpp commit: ${LLAMACPP_COMMIT}"
 fi
 
 if [ "$GGML_CUDA" = "1" ]; then