Instructions to use VladHong/llama-cpp-K2-FAST2 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use VladHong/llama-cpp-K2-FAST2 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 VladHong/llama-cpp-K2-FAST2 # Run inference directly in the terminal: llama cli -hf VladHong/llama-cpp-K2-FAST2
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf VladHong/llama-cpp-K2-FAST2 # Run inference directly in the terminal: llama cli -hf VladHong/llama-cpp-K2-FAST2
Build from source code
git clone https://github.com/ggml-org/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-app # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama serve -hf VladHong/llama-cpp-K2-FAST2 # Run inference directly in the terminal: ./build/bin/llama cli -hf VladHong/llama-cpp-K2-FAST2
Use Docker
docker model run hf.co/VladHong/llama-cpp-K2-FAST2
- Llama new
- LM Studio
- Jan
- Ollama
How to use VladHong/llama-cpp-K2-FAST2 with Ollama:
ollama run hf.co/VladHong/llama-cpp-K2-FAST2
- Unsloth Desktop
- Docker Model Runner
How to use VladHong/llama-cpp-K2-FAST2 with Docker Model Runner:
docker model run hf.co/VladHong/llama-cpp-K2-FAST2
- Lemonade
How to use VladHong/llama-cpp-K2-FAST2 with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull VladHong/llama-cpp-K2-FAST2
Run and chat with the model
lemonade run user.llama-cpp-K2-FAST2-{{QUANT_TAG}}List all available models
lemonade list
- Atomic Chat
Download tools/server/tests/unit/test_vision_api.py from VladHong/llama-cpp-K2-FAST2: direct link, hf CLI and curl.
- Browser
- Download file 6.95 kB
-
https://huggingface.co/VladHong/llama-cpp-K2-FAST2/resolve/main/tools/server/tests/unit/test_vision_api.py
- Command line
-
hf download hf://VladHong/llama-cpp-K2-FAST2/tools/server/tests/unit/test_vision_api.py
-
curl -L -o test_vision_api.py https://huggingface.co/VladHong/llama-cpp-K2-FAST2/resolve/main/tools/server/tests/unit/test_vision_api.py
6.95 kB
| import pytest | |
| from utils import * | |
| import base64 | |
| import requests | |
| server: ServerProcess | |
| def get_img_url(id: str) -> str: | |
| IMG_URL_0 = "https://huggingface.co/ggml-org/tinygemma3-GGUF/resolve/main/test/11_truck.png" | |
| IMG_URL_1 = "https://huggingface.co/ggml-org/tinygemma3-GGUF/resolve/main/test/91_cat.png" | |
| if id == "IMG_URL_0": | |
| return IMG_URL_0 | |
| elif id == "IMG_URL_1": | |
| return IMG_URL_1 | |
| elif id == "IMG_BASE64_URI_0": | |
| response = requests.get(IMG_URL_0) | |
| response.raise_for_status() # Raise an exception for bad status codes | |
| return "data:image/png;base64," + base64.b64encode(response.content).decode("utf-8") | |
| elif id == "IMG_BASE64_0": | |
| response = requests.get(IMG_URL_0) | |
| response.raise_for_status() # Raise an exception for bad status codes | |
| return base64.b64encode(response.content).decode("utf-8") | |
| elif id == "IMG_BASE64_URI_1": | |
| response = requests.get(IMG_URL_1) | |
| response.raise_for_status() # Raise an exception for bad status codes | |
| return "data:image/png;base64," + base64.b64encode(response.content).decode("utf-8") | |
| elif id == "IMG_BASE64_1": | |
| response = requests.get(IMG_URL_1) | |
| response.raise_for_status() # Raise an exception for bad status codes | |
| return base64.b64encode(response.content).decode("utf-8") | |
| else: | |
| return id | |
| JSON_MULTIMODAL_KEY = "multimodal_data" | |
| JSON_PROMPT_STRING_KEY = "prompt_string" | |
| def create_server(): | |
| global server | |
| os.environ['LLAMA_MEDIA_MARKER'] = '<__media__>' | |
| server = ServerPreset.tinygemma3() | |
| def test_models_supports_multimodal_capability(): | |
| global server | |
| server.start() | |
| res = server.make_request("GET", "/models", data={}) | |
| assert res.status_code == 200 | |
| model_info = res.body["models"][0] | |
| print(model_info) | |
| assert "completion" in model_info["capabilities"] | |
| assert "multimodal" in model_info["capabilities"] | |
| def test_v1_models_supports_multimodal_capability(): | |
| global server | |
| server.start() | |
| res = server.make_request("GET", "/v1/models", data={}) | |
| assert res.status_code == 200 | |
| model_info = res.body["models"][0] | |
| print(model_info) | |
| assert "completion" in model_info["capabilities"] | |
| assert "multimodal" in model_info["capabilities"] | |
| def test_vision_chat_completion(prompt, image_url, success, re_content): | |
| global server | |
| server.start() | |
| res = server.make_request("POST", "/chat/completions", data={ | |
| "temperature": 0.0, | |
| "top_k": 1, | |
| "messages": [ | |
| {"role": "user", "content": [ | |
| {"type": "text", "text": prompt}, | |
| {"type": "image_url", "image_url": { | |
| "url": get_img_url(image_url), | |
| }}, | |
| ]}, | |
| ], | |
| }) | |
| if success: | |
| assert res.status_code == 200 | |
| choice = res.body["choices"][0] | |
| assert "assistant" == choice["message"]["role"] | |
| assert match_regex(re_content, choice["message"]["content"]) | |
| else: | |
| assert res.status_code != 200 | |
| def test_vision_chat_completion_token_count(): | |
| global server | |
| server.start() | |
| res = server.make_request("POST", "/chat/completions/input_tokens", data={ | |
| "temperature": 0.0, | |
| "top_k": 1, | |
| "messages": [ | |
| {"role": "user", "content": [ | |
| {"type": "text", "text": "What is this:"}, | |
| {"type": "image_url", "image_url": { | |
| "url": get_img_url("IMG_URL_0"), | |
| }}, | |
| ]}, | |
| ], | |
| }) | |
| assert res.status_code == 200 | |
| assert res.body["input_tokens"] > 10 | |
| def test_vision_completion(prompt, image_data, success, re_content): | |
| global server | |
| server.start() | |
| res = server.make_request("POST", "/completions", data={ | |
| "temperature": 0.0, | |
| "top_k": 1, | |
| "prompt": { | |
| JSON_PROMPT_STRING_KEY: prompt, | |
| JSON_MULTIMODAL_KEY: [ get_img_url(image_data) ], | |
| }, | |
| }) | |
| if success: | |
| assert res.status_code == 200 | |
| content = res.body["content"] | |
| assert match_regex(re_content, content) | |
| else: | |
| assert res.status_code != 200 | |
| def test_vision_embeddings(prompt, image_data, success): | |
| global server | |
| server.server_embeddings = True | |
| server.n_batch = 512 | |
| server.start() | |
| image_data = get_img_url(image_data) | |
| res = server.make_request("POST", "/embeddings", data={ | |
| "content": [ | |
| { JSON_PROMPT_STRING_KEY: prompt, JSON_MULTIMODAL_KEY: [ image_data ] }, | |
| { JSON_PROMPT_STRING_KEY: prompt, JSON_MULTIMODAL_KEY: [ image_data ] }, | |
| { JSON_PROMPT_STRING_KEY: prompt, }, | |
| ], | |
| }) | |
| if success: | |
| assert res.status_code == 200 | |
| content = res.body | |
| # Ensure embeddings are stable when multimodal. | |
| assert content[0]['embedding'] == content[1]['embedding'] | |
| # Ensure embeddings without multimodal but same prompt do not match multimodal embeddings. | |
| assert content[0]['embedding'] != content[2]['embedding'] | |
| else: | |
| assert res.status_code != 200 | |