diff --git a/LICENSE_SOM.txt b/LICENSE_SOM.txt new file mode 100644 index 00000000..eb912c0f --- /dev/null +++ b/LICENSE_SOM.txt @@ -0,0 +1,30 @@ +Software for Open Models License (SOM) +Version 1.0 dated August 30th, 2023 + +This license governs use of the accompanying Software. If you use the Software, you accept this license. If you do not accept the license, do not use the Software. + +This license is intended to encourage open release of models created, modified, processed, or otherwise used via the Software under open licensing terms, and should be interpreted in light of that intent. + +1. Definitions +The “Licensor” is the person or entity who is making the Software available under this license. “Software” is the software made available by Licensor under this license. +A “Model” is the output of a machine learning algorithm, and excludes the Software. +“Model Source Materials” must include the Model and model weights, and may include any input data, input data descriptions, documentation or training descriptions for the Model. +“Open Licensing Terms” means: (a) any open source license approved by the Open Source Initiative, or (b) any other terms that make the Model Source Materials publicly available free of charge, and allow recipients to use, modify and distribute the Model Source Materials. Terms described in (b) may include reasonable restrictions such as non-commercial or non-production limitations, or require use in compliance with law. + +2. Grant of Rights. Subject to the conditions and limitations in section 3: +(A) Copyright Grant. Licensor grants you a non-exclusive, worldwide, royalty-free copyright license to copy, modify, and distribute the Software and any modifications of the Software you create under this license. The foregoing license includes without limitation the right to create, modify, and use Models using this Software. + +(B) Patent Grant. Licensor grants you a non-exclusive, worldwide, royalty-free license, under any patents owned or controlled by Licensor, to make, have made, use, sell, offer for sale, import, or otherwise exploit the Software. No license is granted to patent rights that are not embodied in the operation of the Software in the form provided by Licensor. + +3. Conditions and Limitations +(A) Model Licensing and Access. If you use the Software to create, modify, process, or otherwise use any Model, including usage to create inferences with a Model, whether or not you make the Model available to others, you must make that Model Source Materials publicly available under Open Licensing Terms. + +(B) No Re-Licensing. If you redistribute the Software, or modifications to the Software made under the license granted above, you must make it available only under the terms of this license. You may offer additional terms such as warranties, maintenance and support, but You, and not Licensor, are responsible for performing such terms. + +(C) No Trademark License. This license does not grant you rights to use the Licensor’s name, logo, or trademarks. + +(D) If you assert in writing a claim against any person or entity alleging that the use of the Software infringes any patent, all of your licenses to the Software under Section 2 end automatically as of the date you asserted the claim. + +(E) If you distribute any portion of the Software, you must retain all copyright, patent, trademark, and attribution notices that are present in the Software, and you must include a copy of this license. + +(F) The Software is licensed “as-is.” You bear the entire risk of using it. Licensor gives You no express warranties, guarantees or conditions. You may have additional consumer rights under your local laws that this license cannot change. To the extent permitted under your local laws, the Licensor disclaims and excludes the implied warranties of merchantability, fitness for a particular purpose and non-infringement. To the extent this disclaimer is unlawful, you, and not Licensor, are responsible for any liability. diff --git a/gpt4all-backend/CMakeLists.txt b/gpt4all-backend/CMakeLists.txt index 051b87dd..1b52f981 100644 --- a/gpt4all-backend/CMakeLists.txt +++ b/gpt4all-backend/CMakeLists.txt @@ -20,7 +20,7 @@ endif() include_directories("${CMAKE_CURRENT_BINARY_DIR}") set(LLMODEL_VERSION_MAJOR 0) -set(LLMODEL_VERSION_MINOR 3) +set(LLMODEL_VERSION_MINOR 4) set(LLMODEL_VERSION_PATCH 0) set(LLMODEL_VERSION "${LLMODEL_VERSION_MAJOR}.${LLMODEL_VERSION_MINOR}.${LLMODEL_VERSION_PATCH}") project(llmodel VERSION ${LLMODEL_VERSION} LANGUAGES CXX C) @@ -39,6 +39,8 @@ else() message(STATUS "Interprocedural optimization support detected") endif() +set(LLAMA_KOMPUTE YES) + include(llama.cpp.cmake) set(BUILD_VARIANTS default avxonly) diff --git a/gpt4all-backend/llama.cpp-mainline b/gpt4all-backend/llama.cpp-mainline index acfc5478..4cdaa3c9 160000 --- a/gpt4all-backend/llama.cpp-mainline +++ b/gpt4all-backend/llama.cpp-mainline @@ -1 +1 @@ -Subproject commit acfc5478ff3446ca3b54553967a3dea09b7c771a +Subproject commit 4cdaa3c9cb2d649f45a928d65d900d6b6bb5be3a diff --git a/gpt4all-backend/llama.cpp.cmake b/gpt4all-backend/llama.cpp.cmake index aa2248e1..a99b14ee 100644 --- a/gpt4all-backend/llama.cpp.cmake +++ b/gpt4all-backend/llama.cpp.cmake @@ -1,3 +1,11 @@ +# +# Copyright (c) 2023 Nomic, Inc. All rights reserved. +# +# This software is licensed under the terms of the Software for Open Models License (SOM), +# version 1.0, as detailed in the LICENSE_SOM.txt file. A copy of this license should accompany +# this software. Except as expressly granted in the SOM license, all rights are reserved by Nomic, Inc. +# + cmake_minimum_required(VERSION 3.12) # Don't bump this version for no reason set(CMAKE_EXPORT_COMPILE_COMMANDS ON) @@ -145,6 +153,129 @@ if (LLAMA_OPENBLAS) endif() endif() +if (LLAMA_KOMPUTE) + find_package(Vulkan COMPONENTS glslc REQUIRED) + find_program(glslc_executable NAMES glslc HINTS Vulkan::glslc) + if (NOT glslc_executable) + message(FATAL_ERROR "glslc not found") + endif() + + set(LLAMA_DIR ${CMAKE_CURRENT_SOURCE_DIR}/llama.cpp-mainline) + + function(compile_shader) + set(options) + set(oneValueArgs) + set(multiValueArgs SOURCES) + cmake_parse_arguments(compile_shader "${options}" "${oneValueArgs}" "${multiValueArgs}" ${ARGN}) + foreach(source ${compile_shader_SOURCES}) + get_filename_component(OP_FILE ${source} NAME) + set(spv_file ${CMAKE_CURRENT_BINARY_DIR}/${OP_FILE}.spv) + add_custom_command( + OUTPUT ${spv_file} + DEPENDS ${LLAMA_DIR}/${source} + COMMAND ${glslc_executable} --target-env=vulkan1.2 -o ${spv_file} ${LLAMA_DIR}/${source} + COMMENT "Compiling ${source} to ${source}.spv" + ) + + get_filename_component(RAW_FILE_NAME ${spv_file} NAME) + set(FILE_NAME "shader${RAW_FILE_NAME}") + string(REPLACE ".comp.spv" ".h" HEADER_FILE ${FILE_NAME}) + string(TOUPPER ${HEADER_FILE} HEADER_FILE_DEFINE) + string(REPLACE "." "_" HEADER_FILE_DEFINE "${HEADER_FILE_DEFINE}") + set(OUTPUT_HEADER_FILE "${HEADER_FILE}") + message(STATUS "${HEADER_FILE} generating ${HEADER_FILE_DEFINE}") + add_custom_command( + OUTPUT ${OUTPUT_HEADER_FILE} + COMMAND ${CMAKE_COMMAND} -E echo "/*THIS FILE HAS BEEN AUTOMATICALLY GENERATED - DO NOT EDIT*/" > ${OUTPUT_HEADER_FILE} + COMMAND ${CMAKE_COMMAND} -E echo \"\#ifndef ${HEADER_FILE_DEFINE}\" >> ${OUTPUT_HEADER_FILE} + COMMAND ${CMAKE_COMMAND} -E echo \"\#define ${HEADER_FILE_DEFINE}\" >> ${OUTPUT_HEADER_FILE} + COMMAND ${CMAKE_COMMAND} -E echo "namespace kp {" >> ${OUTPUT_HEADER_FILE} + COMMAND ${CMAKE_COMMAND} -E echo "namespace shader_data {" >> ${OUTPUT_HEADER_FILE} + COMMAND ${CMAKE_BINARY_DIR}/bin/xxd -i ${spv_file} >> ${OUTPUT_HEADER_FILE} + COMMAND ${CMAKE_COMMAND} -E echo "}}" >> ${OUTPUT_HEADER_FILE} + COMMAND ${CMAKE_COMMAND} -E echo \"\#endif // define ${HEADER_FILE_DEFINE}\" >> ${OUTPUT_HEADER_FILE} + DEPENDS ${spv_file} xxd + COMMENT "Converting to hpp: ${FILE_NAME} ${CMAKE_BINARY_DIR}/bin/xxd" + ) + endforeach() + endfunction() + + if (EXISTS "${LLAMA_DIR}/kompute/CMakeLists.txt") + message(STATUS "Kompute found") + add_subdirectory(${LLAMA_DIR}/kompute) + + # Compile our shaders + compile_shader(SOURCES + kompute/op_scale.comp + kompute/op_add.comp + kompute/op_addrow.comp + kompute/op_mul.comp + kompute/op_mulrow.comp + kompute/op_silu.comp + kompute/op_relu.comp + kompute/op_gelu.comp + kompute/op_softmax.comp + kompute/op_norm.comp + kompute/op_rmsnorm.comp + kompute/op_diagmask.comp + kompute/op_mul_mat_f16.comp + kompute/op_mul_mat_q4_0.comp + kompute/op_mul_mat_q4_1.comp + kompute/op_getrows_f16.comp + kompute/op_getrows_q4_0.comp + kompute/op_getrows_q4_1.comp + kompute/op_rope.comp + kompute/op_cpy_f16_f16.comp + kompute/op_cpy_f16_f32.comp + kompute/op_cpy_f32_f16.comp + kompute/op_cpy_f32_f32.comp + ) + + # Create a custom target for our generated shaders + add_custom_target(generated_shaders DEPENDS + shaderop_scale.h + shaderop_add.h + shaderop_addrow.h + shaderop_mul.h + shaderop_mulrow.h + shaderop_silu.h + shaderop_relu.h + shaderop_gelu.h + shaderop_softmax.h + shaderop_norm.h + shaderop_rmsnorm.h + shaderop_diagmask.h + shaderop_mul_mat_f16.h + shaderop_mul_mat_q4_0.h + shaderop_mul_mat_q4_1.h + shaderop_getrows_f16.h + shaderop_getrows_q4_0.h + shaderop_getrows_q4_1.h + shaderop_rope.h + shaderop_cpy_f16_f16.h + shaderop_cpy_f16_f32.h + shaderop_cpy_f32_f16.h + shaderop_cpy_f32_f32.h + ) + + # Create a custom command that depends on the generated_shaders + add_custom_command( + OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/ggml-vulkan.stamp + COMMAND ${CMAKE_COMMAND} -E touch ${CMAKE_CURRENT_BINARY_DIR}/ggml-vulkan.stamp + DEPENDS generated_shaders + COMMENT "Ensuring shaders are generated before compiling ggml-vulkan.cpp" + ) + + # Add the stamp to the main sources to ensure dependency tracking + set(GGML_SOURCES_KOMPUTE ${LLAMA_DIR}/ggml-vulkan.cpp ${LLAMA_DIR}/ggml-vulkan.h ${CMAKE_CURRENT_BINARY_DIR}/ggml-vulkan.stamp) + add_compile_definitions(GGML_USE_KOMPUTE) + set(LLAMA_EXTRA_LIBS ${LLAMA_EXTRA_LIBS} kompute) + set(LLAMA_EXTRA_INCLUDES ${LLAMA_EXTRA_INCLUDES} ${CMAKE_BINARY_DIR}) + else() + message(WARNING "Kompute not found") + endif() +endif() + if (LLAMA_ALL_WARNINGS) if (NOT MSVC) set(c_flags @@ -301,7 +432,8 @@ function(include_ggml DIRECTORY SUFFIX WITH_LLAMA) ${GGML_SOURCES_QUANT_K} ${GGML_SOURCES_CUDA} ${GGML_METAL_SOURCES} - ${GGML_OPENCL_SOURCES}) + ${GGML_OPENCL_SOURCES} + ${GGML_SOURCES_KOMPUTE}) if (LLAMA_K_QUANTS) target_compile_definitions(ggml${SUFFIX} PUBLIC GGML_USE_K_QUANTS) diff --git a/gpt4all-backend/llamamodel.cpp b/gpt4all-backend/llamamodel.cpp index 5fdc35b2..78061dcd 100644 --- a/gpt4all-backend/llamamodel.cpp +++ b/gpt4all-backend/llamamodel.cpp @@ -28,6 +28,9 @@ #include #include +#ifdef GGML_USE_KOMPUTE +#include "ggml-vulkan.h" +#endif namespace { const char *modelType_ = "LLaMA"; @@ -155,6 +158,13 @@ bool LLamaModel::loadModel(const std::string &modelPath) // currently d_ptr->params.n_gpu_layers = 1; #endif +#ifdef GGML_USE_KOMPUTE + if (ggml_vk_has_device()) { + // vulkan always runs the whole model if n_gpu_layers is not 0, at least + // currently + d_ptr->params.n_gpu_layers = 1; + } +#endif d_ptr->ctx = llama_init_from_file(modelPath.c_str(), d_ptr->params); if (!d_ptr->ctx) { @@ -162,6 +172,12 @@ bool LLamaModel::loadModel(const std::string &modelPath) return false; } +#ifdef GGML_USE_KOMPUTE + if (ggml_vk_has_device()) { + std::cerr << "llama.cpp: using Vulkan on " << ggml_vk_current_device().name << std::endl; + } +#endif + d_ptr->n_threads = std::min(4, (int32_t) std::thread::hardware_concurrency()); d_ptr->modelLoaded = true; fflush(stderr); @@ -252,6 +268,75 @@ const std::vector &LLamaModel::endTokens() const return fres; } +#if defined(GGML_USE_KOMPUTE) +#include "ggml-vulkan.h" +#endif + +std::vector LLamaModel::availableGPUDevices(size_t memoryRequired) +{ +#if defined(GGML_USE_KOMPUTE) + std::vector vkDevices = ggml_vk_available_devices(memoryRequired); + + std::vector devices; + for(const auto& vkDevice : vkDevices) { + LLModel::GPUDevice device; + device.index = vkDevice.index; + device.type = vkDevice.type; + device.heapSize = vkDevice.heapSize; + device.name = vkDevice.name; + device.vendor = vkDevice.vendor; + + devices.push_back(device); + } + + return devices; +#else + return std::vector(); +#endif +} + +bool LLamaModel::initializeGPUDevice(size_t memoryRequired, const std::string& device) +{ +#if defined(GGML_USE_KOMPUTE) + return ggml_vk_init_device(memoryRequired, device); +#else + return false; +#endif +} + +bool LLamaModel::initializeGPUDevice(const LLModel::GPUDevice &device) +{ +#if defined(GGML_USE_KOMPUTE) + ggml_vk_device vkDevice; + vkDevice.index = device.index; + vkDevice.type = device.type; + vkDevice.heapSize = device.heapSize; + vkDevice.name = device.name; + vkDevice.vendor = device.vendor; + return ggml_vk_init_device(vkDevice); +#else + return false; +#endif +} + +bool LLamaModel::initializeGPUDevice(int device) +{ +#if defined(GGML_USE_KOMPUTE) + return ggml_vk_init_device(device); +#else + return false; +#endif +} + +bool LLamaModel::hasGPUDevice() +{ +#if defined(GGML_USE_KOMPUTE) + return ggml_vk_has_device(); +#else + return false; +#endif +} + #if defined(_WIN32) #define DLL_EXPORT __declspec(dllexport) #else diff --git a/gpt4all-backend/llamamodel_impl.h b/gpt4all-backend/llamamodel_impl.h index e564c44a..08517dee 100644 --- a/gpt4all-backend/llamamodel_impl.h +++ b/gpt4all-backend/llamamodel_impl.h @@ -25,6 +25,11 @@ public: size_t restoreState(const uint8_t *src) override; void setThreadCount(int32_t n_threads) override; int32_t threadCount() const override; + std::vector availableGPUDevices(size_t memoryRequired) override; + bool initializeGPUDevice(size_t memoryRequired, const std::string& device) override; + bool initializeGPUDevice(const GPUDevice &device) override; + bool initializeGPUDevice(int device) override; + bool hasGPUDevice() override; private: LLamaPrivate *d_ptr; diff --git a/gpt4all-backend/llmodel.h b/gpt4all-backend/llmodel.h index 29706697..0a61cea3 100644 --- a/gpt4all-backend/llmodel.h +++ b/gpt4all-backend/llmodel.h @@ -58,6 +58,14 @@ public: // window }; + struct GPUDevice { + int index = 0; + int type = 0; + size_t heapSize = 0; + std::string name; + std::string vendor; + }; + explicit LLModel() {} virtual ~LLModel() {} @@ -87,6 +95,12 @@ public: return *m_implementation; } + virtual std::vector availableGPUDevices(size_t /*memoryRequired*/) { return std::vector(); } + virtual bool initializeGPUDevice(size_t /*memoryRequired*/, const std::string& /*device*/) { return false; } + virtual bool initializeGPUDevice(const GPUDevice &/*device*/) { return false; } + virtual bool initializeGPUDevice(int /*device*/) { return false; } + virtual bool hasGPUDevice() { return false; } + protected: // These are pure virtual because subclasses need to implement as the default implementation of // 'prompt' above calls these functions diff --git a/gpt4all-backend/llmodel_c.cpp b/gpt4all-backend/llmodel_c.cpp index 58fe27f5..10895f17 100644 --- a/gpt4all-backend/llmodel_c.cpp +++ b/gpt4all-backend/llmodel_c.cpp @@ -5,7 +5,6 @@ #include #include - struct LLModelWrapper { LLModel *llModel = nullptr; LLModel::PromptContext promptContext; @@ -210,3 +209,57 @@ const char *llmodel_get_implementation_search_path() { return LLModel::Implementation::implementationsSearchPath().c_str(); } + +struct llmodel_gpu_device* llmodel_available_gpu_devices(llmodel_model model, size_t memoryRequired, int* num_devices) +{ + LLModelWrapper *wrapper = reinterpret_cast(model); + std::vector devices = wrapper->llModel->availableGPUDevices(memoryRequired); + + // Set the num_devices + *num_devices = devices.size(); + + if (*num_devices == 0) return nullptr; // Return nullptr if no devices are found + + // Allocate memory for the output array + struct llmodel_gpu_device* output = (struct llmodel_gpu_device*) malloc(*num_devices * sizeof(struct llmodel_gpu_device)); + + for (int i = 0; i < *num_devices; i++) { + output[i].index = devices[i].index; + output[i].type = devices[i].type; + output[i].heapSize = devices[i].heapSize; + output[i].name = strdup(devices[i].name.c_str()); // Convert std::string to char* and allocate memory + output[i].vendor = strdup(devices[i].vendor.c_str()); // Convert std::string to char* and allocate memory + } + + return output; +} + +bool llmodel_gpu_init_gpu_device_by_string(llmodel_model model, size_t memoryRequired, const char *device) +{ + LLModelWrapper *wrapper = reinterpret_cast(model); + return wrapper->llModel->initializeGPUDevice(memoryRequired, std::string(device)); +} + +bool llmodel_gpu_init_gpu_device_by_struct(llmodel_model model, const llmodel_gpu_device *device) +{ + LLModel::GPUDevice d; + d.index = device->index; + d.type = device->type; + d.heapSize = device->heapSize; + d.name = device->name; + d.vendor = device->vendor; + LLModelWrapper *wrapper = reinterpret_cast(model); + return wrapper->llModel->initializeGPUDevice(d); +} + +bool llmodel_gpu_init_gpu_device_by_int(llmodel_model model, int device) +{ + LLModelWrapper *wrapper = reinterpret_cast(model); + return wrapper->llModel->initializeGPUDevice(device); +} + +bool llmodel_has_gpu_device(llmodel_model model) +{ + LLModelWrapper *wrapper = reinterpret_cast(model); + return wrapper->llModel->hasGPUDevice(); +} diff --git a/gpt4all-backend/llmodel_c.h b/gpt4all-backend/llmodel_c.h index 138a8853..d56fa28e 100644 --- a/gpt4all-backend/llmodel_c.h +++ b/gpt4all-backend/llmodel_c.h @@ -56,8 +56,18 @@ struct llmodel_prompt_context { int32_t repeat_last_n; // last n tokens to penalize float context_erase; // percent of context to erase if we exceed the context window }; + +struct llmodel_gpu_device { + int index = 0; + int type = 0; // same as VkPhysicalDeviceType + size_t heapSize = 0; + const char * name; + const char * vendor; +}; + #ifndef __cplusplus typedef struct llmodel_prompt_context llmodel_prompt_context; +typedef struct llmodel_gpu_device llmodel_gpu_device; #endif /** @@ -218,6 +228,50 @@ void llmodel_set_implementation_search_path(const char *path); */ const char *llmodel_get_implementation_search_path(); +/** + * Get a list of available GPU devices given the memory required. + * @return A pointer to an array of llmodel_gpu_device's whose number is given by num_devices. + */ +struct llmodel_gpu_device* llmodel_available_gpu_devices(llmodel_model model, size_t memoryRequired, int* num_devices); + +/** + * Initializes a GPU device based on a specified string criterion. + * + * This function initializes a GPU device based on a string identifier provided. The function + * allows initialization based on general device type ("gpu"), vendor name ("amd", "nvidia", "intel"), + * or any specific device name. + * + * @param memoryRequired The amount of memory (in bytes) required by the application or task + * that will utilize the GPU device. + * @param device A string specifying the desired criterion for GPU device selection. It can be: + * - "gpu": To initialize the best available GPU. + * - "amd", "nvidia", or "intel": To initialize the best available GPU from that vendor. + * - A specific GPU device name: To initialize a GPU with that exact name. + * + * @return True if the GPU device is successfully initialized based on the provided string + * criterion. Returns false if the desired GPU device could not be initialized. + */ +bool llmodel_gpu_init_gpu_device_by_string(llmodel_model model, size_t memoryRequired, const char *device); + +/** + * Initializes a GPU device by specifying a valid gpu device pointer. + * @param device A gpu device pointer. + * @return True if the GPU device is successfully initialized, false otherwise. + */ +bool llmodel_gpu_init_gpu_device_by_struct(llmodel_model model, const llmodel_gpu_device *device); + +/** + * Initializes a GPU device by its index. + * @param device An integer representing the index of the GPU device to be initialized. + * @return True if the GPU device is successfully initialized, false otherwise. + */ +bool llmodel_gpu_init_gpu_device_by_int(llmodel_model model, int device); + +/** + * @return True if a GPU device is successfully initialized, false otherwise. + */ +bool llmodel_has_gpu_device(llmodel_model model); + #ifdef __cplusplus } #endif diff --git a/gpt4all-backend/llmodel_shared.h b/gpt4all-backend/llmodel_shared.h index 2bc9ae77..7cae2368 100644 --- a/gpt4all-backend/llmodel_shared.h +++ b/gpt4all-backend/llmodel_shared.h @@ -4,6 +4,49 @@ #include #include +#if defined(GGML_USE_KOMPUTE) +#include "ggml-vulkan.h" +struct llm_buffer { + uint8_t * addr = NULL; + size_t size = 0; + ggml_vk_memory memory; + + llm_buffer() = default; + + void resize(size_t size) { + free(); + + if (!ggml_vk_has_device()) { + this->addr = new uint8_t[size]; + this->size = size; + } else { + this->memory = ggml_vk_allocate(size); + this->addr = (uint8_t*)memory.data; + this->size = size; + } + } + + void free() { + if (!memory.primaryMemory) { + delete[] addr; + } else if (memory.data) { + ggml_vk_free_memory(memory); + } + this->addr = NULL; + this->size = 0; + } + + ~llm_buffer() { + free(); + } + + // disable copy and move + llm_buffer(const llm_buffer&) = delete; + llm_buffer(llm_buffer&&) = delete; + llm_buffer& operator=(const llm_buffer&) = delete; + llm_buffer& operator=(llm_buffer&&) = delete; +}; +#else struct llm_buffer { uint8_t * addr = NULL; size_t size = 0; @@ -18,6 +61,7 @@ struct llm_buffer { delete[] addr; } }; +#endif struct llm_kv_cache { struct ggml_tensor * k; diff --git a/gpt4all-bindings/python/gpt4all/gpt4all.py b/gpt4all-bindings/python/gpt4all/gpt4all.py index e82e6ae4..4776fbdf 100644 --- a/gpt4all-bindings/python/gpt4all/gpt4all.py +++ b/gpt4all-bindings/python/gpt4all/gpt4all.py @@ -66,6 +66,7 @@ class GPT4All: model_type: Optional[str] = None, allow_download: bool = True, n_threads: Optional[int] = None, + device: Optional[str] = "cpu", ): """ Constructor @@ -78,11 +79,22 @@ class GPT4All: descriptive identifier for user. Default is None. allow_download: Allow API to download models from gpt4all.io. Default is True. n_threads: number of CPU threads used by GPT4All. Default is None, then the number of threads are determined automatically. + device: The processing unit on which the GPT4All model will run. It can be set to: + - "cpu": Model will run on the central processing unit. + - "gpu": Model will run on the best available graphics processing unit, irrespective of its vendor. + - "amd", "nvidia", "intel": Model will run on the best available GPU from the specified vendor. + Alternatively, a specific GPU name can also be provided, and the model will run on the GPU that matches the name if it's available. + Default is "cpu". + + Note: If a selected GPU device does not have sufficient RAM to accommodate the model, an error will be thrown, and the GPT4All instance will be rendered invalid. It's advised to ensure the device has enough memory before initiating the model. """ self.model_type = model_type self.model = pyllmodel.LLModel() # Retrieve model and download if allowed self.config: ConfigType = self.retrieve_model(model_name, model_path=model_path, allow_download=allow_download) + if device is not None: + if device != "cpu": + self.model.init_gpu(model_path=self.config["path"], device=device) self.model.load_model(self.config["path"]) # Set n_threads if n_threads is not None: diff --git a/gpt4all-bindings/python/gpt4all/pyllmodel.py b/gpt4all-bindings/python/gpt4all/pyllmodel.py index 6326c493..b2842bde 100644 --- a/gpt4all-bindings/python/gpt4all/pyllmodel.py +++ b/gpt4all-bindings/python/gpt4all/pyllmodel.py @@ -70,6 +70,14 @@ class LLModelPromptContext(ctypes.Structure): ("context_erase", ctypes.c_float), ] +class LLModelGPUDevice(ctypes.Structure): + _fields_ = [ + ("index", ctypes.c_int32), + ("type", ctypes.c_int32), + ("heapSize", ctypes.c_size_t), + ("name", ctypes.c_char_p), + ("vendor", ctypes.c_char_p), + ] # Define C function signatures using ctypes llmodel.llmodel_model_create.argtypes = [ctypes.c_char_p] @@ -125,6 +133,20 @@ llmodel.llmodel_threadCount.restype = ctypes.c_int32 llmodel.llmodel_set_implementation_search_path(MODEL_LIB_PATH.encode("utf-8")) +llmodel.llmodel_available_gpu_devices.argtypes = [ctypes.c_void_p, ctypes.c_size_t, ctypes.POINTER(ctypes.c_int32)] +llmodel.llmodel_available_gpu_devices.restype = ctypes.POINTER(LLModelGPUDevice) + +llmodel.llmodel_gpu_init_gpu_device_by_string.argtypes = [ctypes.c_void_p, ctypes.c_size_t, ctypes.c_char_p] +llmodel.llmodel_gpu_init_gpu_device_by_string.restype = ctypes.c_bool + +llmodel.llmodel_gpu_init_gpu_device_by_struct.argtypes = [ctypes.c_void_p, ctypes.POINTER(LLModelGPUDevice)] +llmodel.llmodel_gpu_init_gpu_device_by_struct.restype = ctypes.c_bool + +llmodel.llmodel_gpu_init_gpu_device_by_int.argtypes = [ctypes.c_void_p, ctypes.c_int32] +llmodel.llmodel_gpu_init_gpu_device_by_int.restype = ctypes.c_bool + +llmodel.llmodel_has_gpu_device.argtypes = [ctypes.c_void_p] +llmodel.llmodel_has_gpu_device.restype = ctypes.c_bool ResponseCallbackType = Callable[[int, str], bool] RawResponseCallbackType = Callable[[int, bytes], bool] @@ -169,6 +191,60 @@ class LLModel: else: raise ValueError("Unable to instantiate model") + def list_gpu(self, model_path: str) -> list: + """ + Lists available GPU devices that satisfy the model's memory requirements. + + Parameters + ---------- + model_path : str + Path to the model. + + Returns + ------- + list + A list of LLModelGPUDevice structures representing available GPU devices. + """ + if self.model is not None: + model_path_enc = model_path.encode("utf-8") + mem_required = llmodel.llmodel_required_mem(self.model, model_path_enc) + else: + mem_required = self.memory_needed(model_path) + num_devices = ctypes.c_int32(0) + devices_ptr = self.llmodel_lib.llmodel_available_gpu_devices(self.model, mem_required, ctypes.byref(num_devices)) + if not devices_ptr: + raise ValueError("Unable to retrieve available GPU devices") + devices = [devices_ptr[i] for i in range(num_devices.value)] + return devices + + def init_gpu(self, model_path: str, device: str): + if self.model is not None: + model_path_enc = model_path.encode("utf-8") + mem_required = llmodel.llmodel_required_mem(self.model, model_path_enc) + else: + mem_required = self.memory_needed(model_path) + device_enc = device.encode("utf-8") + success = self.llmodel_lib.llmodel_gpu_init_gpu_device_by_string(self.model, mem_required, device_enc) + if not success: + # Retrieve all GPUs without considering memory requirements. + num_devices = ctypes.c_int32(0) + all_devices_ptr = self.llmodel_lib.llmodel_available_gpu_devices(self.model, 0, ctypes.byref(num_devices)) + if not all_devices_ptr: + raise ValueError("Unable to retrieve list of all GPU devices") + all_gpus = [all_devices_ptr[i].name.decode('utf-8') for i in range(num_devices.value)] + + # Retrieve GPUs that meet the memory requirements using list_gpu + available_gpus = [device.name.decode('utf-8') for device in self.list_gpu(model_path)] + + # Identify GPUs that are unavailable due to insufficient memory or features + unavailable_gpus = set(all_gpus) - set(available_gpus) + + # Formulate the error message + error_msg = "Unable to initialize model on GPU: '{}'.".format(device) + error_msg += "\nAvailable GPUs: {}.".format(available_gpus) + error_msg += "\nUnavailable GPUs due to insufficient memory or features: {}.".format(unavailable_gpus) + raise ValueError(error_msg) + def load_model(self, model_path: str) -> bool: """ Load model from a file. diff --git a/gpt4all-chat/chatllm.cpp b/gpt4all-chat/chatllm.cpp index f26191bc..e49c4207 100644 --- a/gpt4all-chat/chatllm.cpp +++ b/gpt4all-chat/chatllm.cpp @@ -401,7 +401,7 @@ bool ChatLLM::handlePrompt(int32_t token) #endif ++m_promptTokens; ++m_promptResponseTokens; - m_timer->inc(); + m_timer->start(); return !m_stopGenerating; }