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
| int main(int argc, char ** argv) { | |
| common_params params; | |
| params.prompt = "The quick brown fox"; | |
| params.sampling.seed = 1234; | |
| if (!common_params_parse(argc, argv, params, LLAMA_EXAMPLE_COMMON)) { | |
| return 1; | |
| } | |
| common_init(); | |
| if (params.n_predict < 0) { | |
| params.n_predict = 16; | |
| } | |
| auto n_past = 0; | |
| std::string result0; | |
| std::string result1; | |
| std::string result2; | |
| // init | |
| common_init_result llama_init = common_init_from_params(params); | |
| llama_model * model = llama_init.model.get(); | |
| llama_context * ctx = llama_init.context.get(); | |
| if (model == nullptr || ctx == nullptr) { | |
| fprintf(stderr, "%s : failed to init\n", __func__); | |
| return 1; | |
| } | |
| auto sparams = llama_sampler_chain_default_params(); | |
| llama_sampler * smpl = llama_sampler_chain_init(sparams); | |
| llama_sampler_chain_add(smpl, llama_sampler_init_dist(params.sampling.seed)); | |
| // tokenize prompt | |
| auto tokens = common_tokenize(ctx, params.prompt, true); | |
| // prepare the batch | |
| llama_batch batch = llama_batch_init(tokens.size(), 0, 1); | |
| for (size_t i = 0; i < tokens.size(); i++) { | |
| common_batch_add(batch, tokens[i], i, {0}, false); | |
| } | |
| batch.logits[batch.n_tokens - 1] = true; // generate next token | |
| // evaluate prompt | |
| llama_decode(ctx, batch); | |
| n_past += batch.n_tokens; | |
| // save state (rng, logits, embedding and kv_cache) to file | |
| { | |
| std::vector<uint8_t> state_mem(llama_state_get_size(ctx)); | |
| const size_t written = llama_state_get_data(ctx, state_mem.data(), state_mem.size()); | |
| FILE *fp_write = fopen("dump_state.bin", "wb"); | |
| fwrite(state_mem.data(), 1, written, fp_write); | |
| fclose(fp_write); | |
| fprintf(stderr, "%s : serialized state into %zd out of a maximum of %zd bytes\n", __func__, written, state_mem.size()); | |
| } | |
| // save state (last tokens) | |
| const auto n_past_saved = n_past; | |
| // first run | |
| printf("\nfirst run: %s", params.prompt.c_str()); | |
| for (auto i = 0; i < params.n_predict; i++) { | |
| auto next_token = llama_sampler_sample(smpl, ctx, -1); | |
| auto next_token_str = common_token_to_piece(ctx, next_token); | |
| printf("%s", next_token_str.c_str()); | |
| result0 += next_token_str; | |
| common_batch_clear(batch); | |
| common_batch_add(batch, next_token, n_past, {0}, true); | |
| if (llama_decode(ctx, batch)) { | |
| fprintf(stderr, "\n%s : failed to evaluate\n", __func__); | |
| llama_batch_free(batch); | |
| return 1; | |
| } | |
| n_past += 1; | |
| } | |
| printf("\n\n"); | |
| // make new context | |
| llama_context * ctx2 = llama_init_from_model(model, common_context_params_to_llama(params)); | |
| llama_sampler * smpl2 = llama_sampler_chain_init(sparams); | |
| llama_sampler_chain_add(smpl2, llama_sampler_init_dist(params.sampling.seed)); | |
| printf("\nsecond run: %s", params.prompt.c_str()); | |
| // load state (rng, logits, embedding and kv_cache) from file | |
| { | |
| std::vector<uint8_t> state_mem; | |
| FILE * fp_read = fopen("dump_state.bin", "rb"); | |
| fseek(fp_read, 0, SEEK_END); | |
| state_mem.resize(ftell(fp_read)); | |
| fseek(fp_read, 0, SEEK_SET); | |
| const size_t read = fread(state_mem.data(), 1, state_mem.size(), fp_read); | |
| fclose(fp_read); | |
| if (read != llama_state_set_data(ctx2, state_mem.data(), state_mem.size())) { | |
| fprintf(stderr, "\n%s : failed to read state\n", __func__); | |
| return 1; | |
| } | |
| fprintf(stderr, "%s : deserialized state from %zd out of a maximum of %zd bytes\n", __func__, read, state_mem.size()); | |
| } | |
| // restore state (last tokens) | |
| n_past = n_past_saved; | |
| // second run | |
| for (auto i = 0; i < params.n_predict; i++) { | |
| auto next_token = llama_sampler_sample(smpl2, ctx2, -1); | |
| auto next_token_str = common_token_to_piece(ctx2, next_token); | |
| printf("%s", next_token_str.c_str()); | |
| result1 += next_token_str; | |
| common_batch_clear(batch); | |
| common_batch_add(batch, next_token, n_past, {0}, true); | |
| if (llama_decode(ctx2, batch)) { | |
| fprintf(stderr, "\n%s : failed to evaluate\n", __func__); | |
| llama_batch_free(batch); | |
| return 1; | |
| } | |
| n_past += 1; | |
| } | |
| printf("\n\n"); | |
| if (result0 != result1) { | |
| fprintf(stderr, "\n%s : error : the 2 generations are different\n", __func__); | |
| return 1; | |
| } | |
| // make new context | |
| llama_context * ctx3 = llama_init_from_model(model, common_context_params_to_llama(params)); | |
| llama_sampler * smpl3 = llama_sampler_chain_init(sparams); | |
| llama_sampler_chain_add(smpl3, llama_sampler_init_dist(params.sampling.seed)); | |
| printf("\nsingle seq run: %s", params.prompt.c_str()); | |
| // load state (rng, logits, embedding and kv_cache) from file | |
| { | |
| std::vector<uint8_t> state_mem; | |
| FILE * fp_read = fopen("dump_state.bin", "rb"); | |
| fseek(fp_read, 0, SEEK_END); | |
| state_mem.resize(ftell(fp_read)); | |
| fseek(fp_read, 0, SEEK_SET); | |
| const size_t read = fread(state_mem.data(), 1, state_mem.size(), fp_read); | |
| fclose(fp_read); | |
| if (read != llama_state_set_data(ctx3, state_mem.data(), state_mem.size())) { | |
| fprintf(stderr, "\n%s : failed to read state\n", __func__); | |
| return 1; | |
| } | |
| fprintf(stderr, "%s : deserialized state from %zd out of a maximum of %zd bytes\n", __func__, read, state_mem.size()); | |
| } | |
| // restore state (last tokens) | |
| n_past = n_past_saved; | |
| // save seq 0 and load into seq 1 | |
| { | |
| // save kv of seq 0 | |
| std::vector<uint8_t> seq_store(llama_state_seq_get_size(ctx3, 0)); | |
| const size_t ncopy = llama_state_seq_get_data(ctx3, seq_store.data(), seq_store.size(), 0); | |
| if (ncopy != seq_store.size()) { | |
| fprintf(stderr, "\n%s : seq copy data length %zd does not match expected length %zd\n", __func__, ncopy, seq_store.size()); | |
| return 1; | |
| } | |
| fprintf(stderr, "%s : seq 0 copied, %zd bytes\n", __func__, ncopy); | |
| // erase whole kv | |
| llama_memory_clear(llama_get_memory(ctx3), true); | |
| fprintf(stderr, "%s : kv cache cleared\n", __func__); | |
| // restore kv into seq 1 | |
| const size_t nset = llama_state_seq_set_data(ctx3, seq_store.data(), seq_store.size(), 1); | |
| if (nset != seq_store.size()) { | |
| fprintf(stderr, "\n%s : seq set data length %zd does not match expected length %zd\n", __func__, nset, seq_store.size()); | |
| return 1; | |
| } | |
| fprintf(stderr, "%s : seq 1 restored, %zd bytes\n", __func__, nset); | |
| } | |
| // third run with seq 1 instead of 0 | |
| for (auto i = 0; i < params.n_predict; i++) { | |
| auto next_token = llama_sampler_sample(smpl3, ctx3, -1); | |
| auto next_token_str = common_token_to_piece(ctx3, next_token); | |
| printf("%s", next_token_str.c_str()); | |
| result2 += next_token_str; | |
| common_batch_clear(batch); | |
| common_batch_add(batch, next_token, n_past, {1}, true); | |
| if (llama_decode(ctx3, batch)) { | |
| fprintf(stderr, "\n%s : failed to evaluate\n", __func__); | |
| llama_batch_free(batch); | |
| return 1; | |
| } | |
| n_past += 1; | |
| } | |
| printf("\n"); | |
| llama_sampler_free(smpl); | |
| llama_sampler_free(smpl2); | |
| llama_sampler_free(smpl3); | |
| llama_batch_free(batch); | |
| if (result0 != result2) { | |
| fprintf(stderr, "\n%s : error : the seq restore generation is different\n", __func__); | |
| return 1; | |
| } | |
| fprintf(stderr, "\n%s : success\n", __func__); | |
| return 0; | |
| } | |