Instructions to use miktam/coapi-voice-v2-gguf 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 miktam/coapi-voice-v2-gguf 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 miktam/coapi-voice-v2-gguf:Q4_K_M # Run inference directly in the terminal: llama cli -hf miktam/coapi-voice-v2-gguf:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf miktam/coapi-voice-v2-gguf:Q4_K_M # Run inference directly in the terminal: llama cli -hf miktam/coapi-voice-v2-gguf: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 miktam/coapi-voice-v2-gguf:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf miktam/coapi-voice-v2-gguf: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 miktam/coapi-voice-v2-gguf:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf miktam/coapi-voice-v2-gguf:Q4_K_M
Use Docker
docker model run hf.co/miktam/coapi-voice-v2-gguf:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use miktam/coapi-voice-v2-gguf with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "miktam/coapi-voice-v2-gguf" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "miktam/coapi-voice-v2-gguf", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/miktam/coapi-voice-v2-gguf:Q4_K_M
- Ollama
How to use miktam/coapi-voice-v2-gguf with Ollama:
ollama run hf.co/miktam/coapi-voice-v2-gguf:Q4_K_M
- Unsloth Desktop
- Pi
How to use miktam/coapi-voice-v2-gguf with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf miktam/coapi-voice-v2-gguf: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": "miktam/coapi-voice-v2-gguf:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use miktam/coapi-voice-v2-gguf with Docker Model Runner:
docker model run hf.co/miktam/coapi-voice-v2-gguf:Q4_K_M
- Lemonade
How to use miktam/coapi-voice-v2-gguf with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull miktam/coapi-voice-v2-gguf:Q4_K_M
Run and chat with the model
lemonade run user.coapi-voice-v2-gguf-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use miktam/coapi-voice-v2-gguf with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf miktam/coapi-voice-v2-gguf: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 miktam/coapi-voice-v2-gguf:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use miktam/coapi-voice-v2-gguf with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf miktam/coapi-voice-v2-gguf: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 "miktam/coapi-voice-v2-gguf: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"
coapi-voice-v2 โ evidence, not product
This model is published as the artefact behind a negative result. It is a LoRA fine-tune of Qwen/Qwen3-4B that was measured to be worse than its untrained base on the task it was trained for. It is here so that the claim can be checked and the hypothesis attacked, not so that it can be used. If you want the working configuration, it is the untrained unsloth/Qwen3-4B-GGUF (Q4_K_M) behind retrieval and deterministic post-processing โ see the write-up. Do not use this model for advice on Spanish property transactions.
- Write-up: We Trained It Three Times. Then We Stopped.
- Full experiment (pre-registration, judge files, version records): Chronos exp_035
What it is
An attempt to put the manner of a Spanish real-estate professional โ answer in the question's language (EN/PL/ES), plain text, cite the tema and article, give the Spanish term, hand binding decisions to a professional โ into a small model's weights, while the facts stay in retrieval over our own study notes. The thesis "facts in retrieval, form in the weights" was refuted at this scale: every configuration tried installed the form and lowered the model's use of the facts in front of it.
The model was trained on our study notes; the answers come from the regulation as summarised there. It does not know Spanish law and was never intended to answer without retrieved context in the prompt.
Training
| Base | Qwen/Qwen3-4B (safetensors), fused after training, converted with llama.cpp, quantised to Q4_K_M and Q8_0 |
| Adapter | LoRA rank 16, scale 2.0, dropout 0.05; keys: all seven projections (q, k, v, o, gate, up, down) on all 36 layers โ mlx-lm default; trainable params 33 M |
| Schedule | lr 2e-4, 2 epoch(s) = 364 iterations, batch 2, max sequence 2560 (no truncation), prompt masked, seed 35 |
| Data | 363 train / 14 validation examples, sha256 3c854250bd2a5149โฆ / b3658d7dccdee388โฆ. Written by a frontier model to a brief, with the BM25-retrieved context inside the user turn, regex-gated (every number and citation in the answer exists in the context). Not published: the examples quote our study notes verbatim. |
| Toolchain | mlx-lm 0.31.3, mlx 0.32.2, llama.cpp 6f41ac59e0, Ollama 0.33.0; Mac Mini M4 Pro 64 GB |
| Built | 2026-09-22T07:09:00 |
Result on the sealed 60-row eval (same retrieval, same sampling, same frozen judge rubric)
| Untrained base | v2 | |
|---|---|---|
| Language / plain text / artefact rows | 82 % / 18 % / 44 | 100 % / 100 % / 2 |
| No-advice on advice rows / out-of-scope | 50 % / 0/3 | 100 % / 2/3 |
| Correctness (0โ2) / fully correct | 1.13 / 38 % | 1.05 / 20 % |
| Correctness with substance in context (38 rows) | 1.50 | 1.18 |
| Mรณdulo 6 (held out) vs Mรณdulos 1โ5 | 1.2 / 1.1 | 1.0 / 1.06 โ no memorisation |
| Native Polish / Spanish | 3/17 ยท 9/12 | 1/17 ยท 3/12 |
| Hand-off present | 88 % | 65 % |
| Tail degradation | 10/60 | 28/60 |
Reading. Installs the shape on six of seven floors and degrades what the base had: substance use, native Spanish, hand-off. Validation loss bottoms at iteration 100 and rises; the iteration-100 checkpoint is no better. Root recipe error: LoRA on every projection including the MLP.
What was ruled out as the cause, each by a pre-registered diagnostic: quantisation (Q8_0 same), epochs (val-loss-minimum checkpoint same), sequence truncation (fixed in v2), decoding (temperature 0 and 0.7 same profile), adapter strength (v2 33 M vs v3 1.3 M same damage). The surviving hypothesis is the objective: a few hundred answer-only sequences under prompt masking teach the base a distribution over answers that it follows into invented continuations. One confound is open โ the training answers were written by a much stronger model, and a 4B imitating that register may learn to sound certain where it would have hedged. The falsifying experiment: train on the base's own outputs, shape-edited only. These weights are here so that someone can run it.
Files
| File | Size | sha256 |
|---|---|---|
coapi-voice-v2-Q4_K_M.gguf |
2.50 GB | 924df1f2fee22dbb2640f98abd53e46c1bd2e7952534845399c9d6d1943792b2 |
coapi-voice-v2-Q8_0.gguf |
4.28 GB | 7eaecfa97e03b4aefc4715c6b0d70f5cae5f6e0f7c5eb70dba6dcfd0948e8a7e |
adapters/ |
the mlx-lm LoRA adapter as trained | |
lora_config.yaml, version_record.json |
exact configuration and environment |
Running it (to reproduce, not to use)
ollama run hf.co/miktam/coapi-voice-v2-gguf:Q4_K_M
Thinking off (/no_think), temperature 0 / seed 42 for the scored pass; shipped sampling was temperature 0.7, top_k 20, top_p 0.8, min_p 0.05, repeat 1.05, presence 0. The pre-registration, version records and judge files are in the experiment directory linked above, where the eval set is sealed by hash; the eval runner, scorer and retrieval code are not published.
Rights
Trained only on the authors' own study notes. No course materials, no client or buyer data, no conversation logs entered the training set, the eval, or the retrieval index. Base model Apache-2.0 (Qwen); this derivative is released under the same licence.
- Downloads last month
- -
4-bit
8-bit