Text Generation
Transformers
Safetensors
GGUF
llama
chatbot
multilingual
arabic
french
tamazight
english
conversational
text-generation-inference
4-bit precision
bitsandbytes
Instructions to use kaisser/LLM-Maroc with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use kaisser/LLM-Maroc with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="kaisser/LLM-Maroc") messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("kaisser/LLM-Maroc") model = AutoModelForCausalLM.from_pretrained("kaisser/LLM-Maroc", device_map="auto") messages = [ {"role": "user", "content": "Who are you?"}, ] inputs = tokenizer.apply_chat_template( messages, add_generation_prompt=True, tokenize=True, return_dict=True, return_tensors="pt", ).to(model.device) outputs = model.generate(**inputs, max_new_tokens=40) print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use kaisser/LLM-Maroc with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf kaisser/LLM-Maroc:BF16 # Run inference directly in the terminal: llama cli -hf kaisser/LLM-Maroc:BF16
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf kaisser/LLM-Maroc:BF16 # Run inference directly in the terminal: llama cli -hf kaisser/LLM-Maroc:BF16
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf kaisser/LLM-Maroc:BF16 # Run inference directly in the terminal: ./llama-cli -hf kaisser/LLM-Maroc:BF16
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf kaisser/LLM-Maroc:BF16 # Run inference directly in the terminal: ./build/bin/llama-cli -hf kaisser/LLM-Maroc:BF16
Use Docker
docker model run hf.co/kaisser/LLM-Maroc:BF16
- LM Studio
- Jan
- vLLM
How to use kaisser/LLM-Maroc with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "kaisser/LLM-Maroc" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "kaisser/LLM-Maroc", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/kaisser/LLM-Maroc:BF16
- SGLang
How to use kaisser/LLM-Maroc with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "kaisser/LLM-Maroc" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "kaisser/LLM-Maroc", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "kaisser/LLM-Maroc" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "kaisser/LLM-Maroc", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Ollama
How to use kaisser/LLM-Maroc with Ollama:
ollama run hf.co/kaisser/LLM-Maroc:BF16
- Unsloth Studio
How to use kaisser/LLM-Maroc with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for kaisser/LLM-Maroc to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for kaisser/LLM-Maroc to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for kaisser/LLM-Maroc to start chatting
- Docker Model Runner
How to use kaisser/LLM-Maroc with Docker Model Runner:
docker model run hf.co/kaisser/LLM-Maroc:BF16
- Lemonade
How to use kaisser/LLM-Maroc with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull kaisser/LLM-Maroc:BF16
Run and chat with the model
lemonade run user.LLM-Maroc-BF16
List all available models
lemonade list
- Atomic Chat
| using json = nlohmann::ordered_json; | |
| enum common_json_stack_element_type { | |
| COMMON_JSON_STACK_ELEMENT_OBJECT, | |
| COMMON_JSON_STACK_ELEMENT_KEY, | |
| COMMON_JSON_STACK_ELEMENT_ARRAY, | |
| }; | |
| struct common_json_stack_element { | |
| common_json_stack_element_type type; | |
| std::string key; | |
| }; | |
| bool common_json_parse( | |
| const std::string & input, | |
| const std::string & healing_marker, | |
| common_json & out) | |
| { | |
| std::string::const_iterator it = input.begin(); | |
| const auto end = input.end(); | |
| return common_json_parse(it, end, healing_marker, out); | |
| } | |
| bool common_json_parse( | |
| std::string::const_iterator & it, | |
| const std::string::const_iterator & end, | |
| const std::string & healing_marker, | |
| common_json & out) | |
| { | |
| // // https://json.nlohmann.me/features/parsing/sax_interface/ | |
| struct json_error_locator : public nlohmann::json_sax<json> { | |
| std::size_t position; | |
| bool found_error; | |
| std::string last_token; | |
| std::string exception_message; | |
| std::vector<common_json_stack_element> stack; | |
| json_error_locator() : position(0), found_error(false) {} | |
| bool parse_error(std::size_t position, const std::string & last_token, const json::exception & ex) override { // NOLINT | |
| this->position = position - 1; | |
| this->found_error = true; | |
| this->last_token = last_token; | |
| this->exception_message = ex.what(); | |
| return false; | |
| } | |
| void close_value() { | |
| if (!stack.empty() && (stack.back().type == COMMON_JSON_STACK_ELEMENT_KEY)) { | |
| stack.pop_back(); | |
| } | |
| } | |
| bool null() override { // NOLINT | |
| close_value(); | |
| return true; | |
| } | |
| bool boolean(bool) override { // NOLINT | |
| close_value(); | |
| return true; | |
| } | |
| bool number_integer(number_integer_t) override { // NOLINT | |
| close_value(); | |
| return true; | |
| } | |
| bool number_unsigned(number_unsigned_t) override { // NOLINT | |
| close_value(); | |
| return true; | |
| } | |
| bool number_float(number_float_t, const string_t &) override { // NOLINT | |
| close_value(); | |
| return true; | |
| } | |
| bool string(string_t &) override { // NOLINT | |
| close_value(); | |
| return true; | |
| } | |
| bool binary(binary_t &) override { // NOLINT | |
| close_value(); | |
| return true; | |
| } | |
| bool start_object(std::size_t) override { // NOLINT | |
| stack.push_back({COMMON_JSON_STACK_ELEMENT_OBJECT, ""}); | |
| return true; | |
| } | |
| bool end_object() override { | |
| GGML_ASSERT(!stack.empty() && stack.back().type == COMMON_JSON_STACK_ELEMENT_OBJECT); | |
| stack.pop_back(); | |
| close_value(); | |
| return true; | |
| } | |
| bool key(string_t & key) override { // NOLINT | |
| stack.push_back({COMMON_JSON_STACK_ELEMENT_KEY, key}); | |
| return true; | |
| } | |
| bool start_array(std::size_t) override { // NOLINT | |
| stack.push_back({COMMON_JSON_STACK_ELEMENT_ARRAY, ""}); | |
| return true; | |
| } | |
| bool end_array() override { | |
| GGML_ASSERT(!stack.empty() && stack.back().type == COMMON_JSON_STACK_ELEMENT_ARRAY); | |
| stack.pop_back(); | |
| close_value(); | |
| return true; | |
| } | |
| }; | |
| json_error_locator err_loc; | |
| auto start = it; | |
| json::sax_parse(it, end, &err_loc); | |
| if (err_loc.found_error) { | |
| it = start; | |
| auto temptative_end = it + err_loc.position; | |
| // LOG_DBG("Error at position %zu (is_end = %s): %s\n", err_loc.position, temptative_end == end ? "true" : "false", err_loc.exception_message.c_str()); | |
| auto input = std::string(it, temptative_end); | |
| try { | |
| out.json = json::parse(input); | |
| // out.json = json::parse(it, temptative_end); | |
| it = temptative_end; | |
| return true; | |
| } catch (const std::exception & ex) { | |
| // No, needs healing. | |
| LOG_DBG("Failed to parse up to error: %s: <<<%s>>>\n", ex.what(), std::string(it, temptative_end).c_str()); | |
| } | |
| auto can_parse = [](const std::string & str) { | |
| try { | |
| auto _ = json::parse(str); // NOLINT | |
| return true; | |
| } catch (const std::exception &) { | |
| return false; | |
| } | |
| }; | |
| if (!healing_marker.empty() && !err_loc.stack.empty()) { | |
| std::string str(it, temptative_end); | |
| auto last_non_sp_pos = str.find_last_not_of(" \n\r\t"); | |
| if (last_non_sp_pos == std::string::npos) { | |
| throw std::runtime_error("Cannot heal a truncated JSON that stopped in an unknown location"); | |
| } | |
| auto last_non_sp_char = str[last_non_sp_pos]; | |
| // Used to detect stops on a number, which may not be complete. | |
| auto was_maybe_number = [&]() { | |
| if (!str.empty() && std::isspace(str.back())) { | |
| return false; | |
| } | |
| return std::isdigit(last_non_sp_char) || | |
| last_non_sp_char == '.' || | |
| last_non_sp_char == 'e' || | |
| last_non_sp_char == 'E' || | |
| last_non_sp_char == '-'; | |
| }; | |
| std::string closing; | |
| for (size_t i = err_loc.stack.size(); i > 0; i--) { | |
| auto & el = err_loc.stack[i - 1]; | |
| if (el.type == COMMON_JSON_STACK_ELEMENT_OBJECT) { | |
| closing += "}"; | |
| } else if (el.type == COMMON_JSON_STACK_ELEMENT_ARRAY) { | |
| closing += "]"; | |
| } else if (el.type != COMMON_JSON_STACK_ELEMENT_KEY) { | |
| throw std::runtime_error("Unexpected stack element type"); | |
| } | |
| } | |
| const auto & magic_seed = out.healing_marker.marker = healing_marker;//"$llama.cpp.json$"; | |
| if (err_loc.stack.back().type == COMMON_JSON_STACK_ELEMENT_KEY) { | |
| // We're inside an object value | |
| if (last_non_sp_char == ':' && can_parse(str + "1" + closing)) { | |
| // Was about to create an object value | |
| str += (out.healing_marker.json_dump_marker = "\"" + magic_seed) + "\"" + closing; | |
| } else if (can_parse(str + ": 1" + closing)) { | |
| str += (out.healing_marker.json_dump_marker = ":\"" + magic_seed) + "\"" + closing; | |
| } else if (last_non_sp_char == '{' && can_parse(str + closing)) { | |
| // Was about to create an object | |
| str += (out.healing_marker.json_dump_marker = "\"" + magic_seed) + "\": 1" + closing; | |
| } else if (can_parse(str + "\"" + closing)) { | |
| // Was inside an object value string | |
| str += (out.healing_marker.json_dump_marker = magic_seed) + "\"" + closing; | |
| } else if (str[str.length() - 1] == '\\' && can_parse(str + "\\\"" + closing)) { | |
| // Was inside an object value string after an escape | |
| str += (out.healing_marker.json_dump_marker = "\\" + magic_seed) + "\"" + closing; | |
| } else { | |
| // find last : | |
| auto last_pos = str.find_last_of(':'); | |
| if (last_pos == std::string::npos) { | |
| throw std::runtime_error("Cannot heal a truncated JSON that stopped in an unknown location"); | |
| } | |
| // Cutting back to opening : for object value | |
| str = str.substr(0, last_pos + 1) + (out.healing_marker.json_dump_marker = "\"" + magic_seed) + "\"" + closing; | |
| } | |
| } else if (err_loc.stack.back().type == COMMON_JSON_STACK_ELEMENT_ARRAY) { | |
| if ((last_non_sp_char == ',' || last_non_sp_char == '[') && can_parse(str + "1" + closing)) { | |
| // Was about to create an array value | |
| str += (out.healing_marker.json_dump_marker = "\"" + magic_seed) + "\"" + closing; | |
| } else if (can_parse(str + "\"" + closing)) { | |
| // Was inside an array value string | |
| str += (out.healing_marker.json_dump_marker = magic_seed) + "\"" + closing; | |
| } else if (str[str.length() - 1] == '\\' && can_parse(str + "\\\"" + closing)) { | |
| // Was inside an array value string after an escape | |
| str += (out.healing_marker.json_dump_marker = "\\" + magic_seed) + "\"" + closing; | |
| } else if (!was_maybe_number() && can_parse(str + ", 1" + closing)) { | |
| // Had just finished a value | |
| str += (out.healing_marker.json_dump_marker = ",\"" + magic_seed) + "\"" + closing; | |
| } else { | |
| auto last_pos = str.find_last_of("[,"); | |
| if (last_pos == std::string::npos) { | |
| throw std::runtime_error("Cannot heal a truncated JSON array stopped in an unknown location"); | |
| } | |
| // Cutting back to last [ or , for array value | |
| str = str.substr(0, last_pos + 1) + (out.healing_marker.json_dump_marker = "\"" + magic_seed) + "\"" + closing; | |
| } | |
| } else if (err_loc.stack.back().type == COMMON_JSON_STACK_ELEMENT_OBJECT) { | |
| if ((last_non_sp_char == '{' && can_parse(str + closing)) || | |
| (last_non_sp_char == ',' && can_parse(str + "\"\": 1" + closing))) { | |
| // Was about to create an object key+value | |
| str += (out.healing_marker.json_dump_marker = "\"" + magic_seed) + "\": 1" + closing; | |
| } else if (!was_maybe_number() && can_parse(str + ",\"\": 1" + closing)) { | |
| // Was about to create an object key+value | |
| str += (out.healing_marker.json_dump_marker = ",\"" + magic_seed) + "\": 1" + closing; | |
| } else if (can_parse(str + "\": 1" + closing)) { | |
| // Was inside an object key string | |
| str += (out.healing_marker.json_dump_marker = magic_seed) + "\": 1" + closing; | |
| } else if (str[str.length() - 1] == '\\' && can_parse(str + "\\\": 1" + closing)) { | |
| // Was inside an object key string after an escape | |
| str += (out.healing_marker.json_dump_marker = "\\" + magic_seed) + "\": 1" + closing; | |
| } else { | |
| auto last_pos = str.find_last_of(':'); | |
| if (last_pos == std::string::npos) { | |
| throw std::runtime_error("Cannot heal a truncated JSON object stopped in an unknown location"); | |
| } | |
| // fprintf(stderr, "Cutting back to last : for object key+value\n"); | |
| str = str.substr(0, last_pos + 1) + (out.healing_marker.json_dump_marker = "\"" + magic_seed) + "\"" + closing; | |
| } | |
| } else { | |
| throw std::runtime_error("Cannot heal a truncated JSON object stopped in an unknown location"); | |
| } | |
| // fprintf(stderr, "HEALED:\nSTRING <<<\n%s\n>>>\n\nmagic_cut: <<<\n%s\n>>>\n\n", str.c_str(), out.healing_marker.json_dump_marker.c_str()); | |
| out.json = json::parse(str); | |
| it = temptative_end; | |
| return true; | |
| } | |
| // TODO: handle unclosed top-level primitive if the stack was empty but we got an error (e.g. "tru", "\"", etc...) | |
| // fprintf(stderr, "Closing: TODO\n"); | |
| return false; | |
| } | |
| out.json = json::parse(it, end); | |
| it = end; | |
| return true; | |
| } | |