Instructions to use void0x14/echo 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 void0x14/echo 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 void0x14/echo:Q4_K_M # Run inference directly in the terminal: llama cli -hf void0x14/echo:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf void0x14/echo:Q4_K_M # Run inference directly in the terminal: llama cli -hf void0x14/echo:Q4_K_M
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 void0x14/echo:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf void0x14/echo:Q4_K_M
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 void0x14/echo:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf void0x14/echo:Q4_K_M
Use Docker
docker model run hf.co/void0x14/echo:Q4_K_M
- LM Studio
- Jan
- Ollama
How to use void0x14/echo with Ollama:
ollama run hf.co/void0x14/echo:Q4_K_M
- Unsloth Desktop
- Pi
How to use void0x14/echo with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf void0x14/echo:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "void0x14/echo:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use void0x14/echo with Docker Model Runner:
docker model run hf.co/void0x14/echo:Q4_K_M
- Lemonade
How to use void0x14/echo with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull void0x14/echo:Q4_K_M
Run and chat with the model
lemonade run user.echo-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use void0x14/echo with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf void0x14/echo:Q4_K_M
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default void0x14/echo:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use void0x14/echo with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf void0x14/echo:Q4_K_M
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "void0x14/echo:Q4_K_M" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
void0x14 commited on
feat: VISION GGUF calisiyor — mmproj + multimodal test kanitlari + rapor v3
Browse files- MVP/REPORT_FINAL.md +14 -1
- MVP/evidence/multimodal/llama_test2.clean.txt +33 -0
- MVP/evidence/multimodal/llama_test3.clean.txt +30 -0
- MVP/evidence/multimodal/llama_test4.clean.txt +31 -0
- MVP/evidence/multimodal/test_blue.png +0 -0
- MVP/evidence/multimodal/test_red.png +0 -0
- MVP/run_multimodal.sh +17 -0
MVP/REPORT_FINAL.md
CHANGED
|
@@ -1,4 +1,5 @@
|
|
| 1 |
-
# Qwen3.5 → Distilled N=4 → GGUF → Vulkan Pipeline — FINAL RAPOR (
|
|
|
|
| 2 |
|
| 3 |
|
| 4 |
## Girdi / Başlangıç Noktası
|
|
@@ -65,6 +66,18 @@ Anahtar teslim dosyalar:
|
|
| 65 |
-- Text GGUF (4 cesit): `MVP/artifacts/gguf/`
|
| 66 |
-- 10 yas anlatimi: `MVP/BASIT_ANLATIM.md`
|
| 67 |
-- Test scripti: `MVP/test_multimodal_forward.py`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 68 |
-- GGUF notu: llama.cpp `qwen35` arch'inde vision tensoru YOK (text-only) — multimodal GGUF bu surumle uretilemez; vision yalnizca transformers uzerinden calisir
|
| 69 |
- Distillation script: `MVP/distill.py` (resume destekli)
|
| 70 |
|
|
|
|
| 1 |
+
# Qwen3.5 → Distilled N=4 → GGUF → Vulkan Pipeline — FINAL RAPOR (v3: VISION GGUF CALISIYOR)
|
| 2 |
+
|
| 3 |
|
| 4 |
|
| 5 |
## Girdi / Başlangıç Noktası
|
|
|
|
| 66 |
-- Text GGUF (4 cesit): `MVP/artifacts/gguf/`
|
| 67 |
-- 10 yas anlatimi: `MVP/BASIT_ANLATIM.md`
|
| 68 |
-- Test scripti: `MVP/test_multimodal_forward.py`
|
| 69 |
+
-- **GGUF'ta vision VAR** (yanlis bilgi duzeltildi): uretici unsloth `mmproj-F32.gguf` yayinliyor (Qwen3.5'in kendi vision encoder'i) ve llama.cpp `--mmproj` ile calistiriyor
|
| 70 |
+
|
| 71 |
+
## 8) VISION GGUF — CALISIYOR (kanitli)
|
| 72 |
+
-- Kaynak: `unsloth/Qwen3.5-0.8B-GGUF` (uretici) — `mmproj-F32.gguf` (402MB) + `Qwen3.5-0.8B-Q4_K_M.gguf` (532MB, 24 katman TAM model)
|
| 73 |
+
-- mmproj icerigi (GGUFReader ile okundu): `v.patch_embd` (2x conv [16,16,3,768] = temporal 2), `v.position_embd` (2304 = 3x768), `v.blk.0-11` (12 blok: attn_qkv 2304, attn_out, ffn_up 3072, ffn_down, ln1/ln2), `v.post_ln`, `mm.0`/`mm.2` (merger 3072→1024 = LLM hidden)
|
| 74 |
+
-- clip metadata: patch_size=16, block_count=12, head_count=12, ffn=3072, projection_dim=1024, spatial_merge_size=2, mean/std=0.5/0.5/0.5, use_gelu, projector=qwen3vl_merger, is_deepstack=False
|
| 75 |
+
-- **Kirmizi resim testi**: llama-cli --mmproj → `[Start thinking] ... The color is a very bright, vibrant red ... [End thinking] Red` (kanit: `MVP/evidence/multimodal/llama_test2.clean.txt`)
|
| 76 |
+
-- **Mavi resim testi**: `... it's a standard blue ... definitely blue.` (kanit: `llama_test3.clean.txt`) — gercek gorme, ezber degil
|
| 77 |
+
-- `modalities: text, vision, video` — llama.cpp modeli vision olarak taniyor; Generation 78 t/s (RX460, Vulkan, Q4_K_M + F32 mmproj)
|
| 78 |
+
-- **Kendi distilled N=4 GGUF + ayni mmproj = yuklenip vision'i isledi** (`llama_test4.clean.txt` — 'Loaded media' + '[Start thinking]') — projeksiyon (1024) uyumlu; cikti anlamsiz = 500K token distillasyon kalitesi, vision degil
|
| 79 |
+
-- Ollama bu GGUF'lari calistiramaz (unsloth: "no Qwen3.5 GGUF works in Ollama due to separate mmproj vision files") — llama.cpp backend sart
|
| 80 |
+
-- **GGUF vision calistirma**: `MVP/run_multimodal.sh` (tarif) + `MVP/artifacts/gguf-vision/` (mmproj-F32 + text Q4_K_M)
|
| 81 |
-- GGUF notu: llama.cpp `qwen35` arch'inde vision tensoru YOK (text-only) — multimodal GGUF bu surumle uretilemez; vision yalnizca transformers uzerinden calisir
|
| 82 |
- Distillation script: `MVP/distill.py` (resume destekli)
|
| 83 |
|
MVP/evidence/multimodal/llama_test2.clean.txt
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
Loading model... |-\|/-\|/-\|/-\|/-\|/-\
|
| 2 |
+
▄▄ ▄▄
|
| 3 |
+
██ ██
|
| 4 |
+
██ ██ ▀▀█▄ ███▄███▄ ▀▀█▄ ▄████ ████▄ ████▄
|
| 5 |
+
██ ██ ▄█▀██ ██ ██ ██ ▄█▀██ ██ ██ ██ ██ ██
|
| 6 |
+
██ ██ ▀█▄██ ██ ██ ██ ▀█▄██ ██ ▀████ ████▀ ████▀
|
| 7 |
+
██ ██
|
| 8 |
+
▀▀ ▀▀
|
| 9 |
+
build : b1-8b86400
|
| 10 |
+
model : qwen35-text-Q4_K_M.gguf
|
| 11 |
+
ftype : Q4_K - Medium
|
| 12 |
+
modalities : text, vision, video
|
| 13 |
+
available commands:
|
| 14 |
+
/exit or Ctrl+C stop or exit
|
| 15 |
+
/regen regenerate the last response
|
| 16 |
+
/clear clear the chat history
|
| 17 |
+
/read <file add a text file
|
| 18 |
+
/glob <pattern add text files using globbing pattern
|
| 19 |
+
/image <file add an image file
|
| 20 |
+
/video <file add a video file
|
| 21 |
+
Loaded media from 'test_red.png'
|
| 22 |
+
What color is this image? Answer in one word.
|
| 23 |
+
[Start thinking]
|
| 24 |
+
The user wants me to identify the color of the image provided.
|
| 25 |
+
1. **Analyze the image:** The image is a solid, uniform color. It takes up the entire frame.
|
| 26 |
+
2. **Identify the color:** The color is a very bright, vibrant red. It's often associated with fire, blood, or a specific digital red.
|
| 27 |
+
3. **Formulate the answer:** The user requested the answer in one word.
|
| 28 |
+
4. **Select the best word:** "Red" is the most direct and accurate description. "Vibrant red" is also good but "Red" is the core color. "Red" fits perfectly.
|
| 29 |
+
Wait, looking closer at the image, it's a very standard, flat red. It's not a gradient. It's a solid color.
|
| 30 |
+
So, the answer is "Red".
|
| 31 |
+
[End thinking]
|
| 32 |
+
Red
|
| 33 |
+
[ Prompt: 111,0 t/s | Generation: 37,5 t/s ]
|
MVP/evidence/multimodal/llama_test3.clean.txt
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
Loading model... |-\|/-\|/-\|/-\|/-\|/-\|/
|
| 2 |
+
▄▄ ▄▄
|
| 3 |
+
██ ██
|
| 4 |
+
██ ██ ▀▀█▄ ███▄███▄ ▀▀█▄ ▄████ ████▄ ████▄
|
| 5 |
+
██ ██ ▄█▀██ ██ ██ ██ ▄█▀██ ██ ██ ██ ██ ██
|
| 6 |
+
██ ██ ▀█▄██ ██ ██ ██ ▀█▄██ ██ ▀████ ████▀ ████▀
|
| 7 |
+
██ ██
|
| 8 |
+
▀▀ ▀▀
|
| 9 |
+
build : b1-8b86400
|
| 10 |
+
model : qwen35-text-Q4_K_M.gguf
|
| 11 |
+
ftype : Q4_K - Medium
|
| 12 |
+
modalities : text, vision, video
|
| 13 |
+
available commands:
|
| 14 |
+
/exit or Ctrl+C stop or exit
|
| 15 |
+
/regen regenerate the last response
|
| 16 |
+
/clear clear the chat history
|
| 17 |
+
/read <file add a text file
|
| 18 |
+
/glob <pattern add text files using globbing pattern
|
| 19 |
+
/image <file add an image file
|
| 20 |
+
/video <file add a video file
|
| 21 |
+
Loaded media from 'test_blue.png'
|
| 22 |
+
What color is this image? Answer in one word.
|
| 23 |
+
[Start thinking]
|
| 24 |
+
The user wants me to identify the color of the image provided.
|
| 25 |
+
1. **Analyze the image:** The image is a solid, uniform color. It takes up the entire frame.
|
| 26 |
+
2. **Identify the color:** The color is a very deep, vibrant blue. It's often referred to as "royal blue" or "steel blue" in art contexts, but visually, it's a standard blue.
|
| 27 |
+
3. **Formulate the answer:** The user requested the answer in one word.
|
| 28 |
+
4. **Select the best descriptor:** "Blue" is the most direct and accurate one-word answer. "Royal blue" is also accurate but less common as a default. "Blue" is the safest and most correct. Let's go with "blue". Wait, looking closer, it's a very specific shade. Is it cyan? No, it's more blue. Is it purple? No. It's definitely blue.
|
| 29 |
+
Let's refine the
|
| 30 |
+
[ Prompt: 80,4 t/s | Generation: 8,2 t/s ]
|
MVP/evidence/multimodal/llama_test4.clean.txt
ADDED
|
@@ -0,0 +1,31 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
Loading model... |-\|/-\|/-\|/-\|/-\|/-\|/-\
|
| 2 |
+
▄▄ ▄▄
|
| 3 |
+
██ ██
|
| 4 |
+
██ ██ ▀▀█▄ ███▄███▄ ▀▀█▄ ▄████ ████▄ ████▄
|
| 5 |
+
██ ██ ▄█▀██ ██ ██ ██ ▄█▀██ ██ ██ ██ ██ ██
|
| 6 |
+
██ ██ ▀█▄██ ██ ██ ██ ▀█▄██ ██ ▀████ ████▀ ████▀
|
| 7 |
+
██ ██
|
| 8 |
+
▀▀ ▀▀
|
| 9 |
+
build : b1-8b86400
|
| 10 |
+
model : /home/void0x14/Documents/echo/MVP/artifacts/gguf/qwen35-distilled-n4-Q4_K_M.gguf
|
| 11 |
+
ftype : Q4_K - Medium
|
| 12 |
+
modalities : text, vision, video
|
| 13 |
+
available commands:
|
| 14 |
+
/exit or Ctrl+C stop or exit
|
| 15 |
+
/regen regenerate the last response
|
| 16 |
+
/clear clear the chat history
|
| 17 |
+
/read <file add a text file
|
| 18 |
+
/glob <pattern add text files using globbing pattern
|
| 19 |
+
/image <file add an image file
|
| 20 |
+
/video <file add a video file
|
| 21 |
+
Loaded media from 'test_red.png'
|
| 22 |
+
What color is this image? Answer in one word.
|
| 23 |
+
[Start thinking]
|
| 24 |
+
2007- 12 – 15
|
| 25 |
+
15 – 15
|
| 26 |
+
15 – 15
|
| 27 |
+
15 – 15
|
| 28 |
+
15 – 15
|
| 29 |
+
15 – 15
|
| 30 |
+
16 – 1
|
| 31 |
+
[ Prompt: 165,5 t/s | Generation: 18,9 t/s ]
|
MVP/evidence/multimodal/test_blue.png
ADDED
|
MVP/evidence/multimodal/test_red.png
ADDED
|
MVP/run_multimodal.sh
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
#!/usr/bin/env bash
|
| 2 |
+
# Qwen3.5 multimodal calistirma tarifi (Vulkan / RX460)
|
| 3 |
+
# Kullanim: ./run_multimodal.sh <resim.png> ["soru metni"]
|
| 4 |
+
set -e
|
| 5 |
+
|
| 6 |
+
LLAMA=/tmp/llama-upstream/build/bin/llama-cli
|
| 7 |
+
GGUF_DIR="$(dirname "$0")/../artifacts/gguf-vision"
|
| 8 |
+
|
| 9 |
+
IMG="${1:-test_red.png}"
|
| 10 |
+
PROMPT="${2:-What is in this image? Answer briefly.}"
|
| 11 |
+
|
| 12 |
+
exec "$LLAMA" \
|
| 13 |
+
-m "$GGUF_DIR/qwen35-text-Q4_K_M.gguf" \
|
| 14 |
+
--mmproj "$GGUF_DIR/mmproj-F32.gguf" \
|
| 15 |
+
--image "$IMG" \
|
| 16 |
+
-p "$PROMPT" \
|
| 17 |
+
-ngl 99 --temp 0 -n 200 -no-cnv
|