MedPsy-4B-GGUF

MedPsy-4B-GGUF provides GGUF weights of MedPsy-4B for fast, fully on-device inference via llama.cpp and the QVAC SDK. An unquantized BF16 GGUF file (about 8.83 GB) is included alongside seven quantization formats, ranging from near-lossless 8-bit (about 4.69 GB) through a high-quality 5-bit option (about 3.16 GB) down to ultra-compact 3-bit (about 1.84 GB), making the same model deployable across everything from workstations to high-end mobile devices.

Available Files

All published files are produced with llama.cpp. The BF16 GGUF file is unquantized: no quantization is applied. We have not separately re-evaluated the BF16 GGUF with llama.cpp; because it preserves the same BF16 tensor precision as the source checkpoint, performance is expected to match the BF16 source model evaluated with vLLM, aside from small backend or runtime differences. Q8_0 does not use imatrix calibration (we verified that imatrix provided no measurable benefit at 8-bit). All sub-8-bit variants use importance-matrix (imatrix) calibration, which consistently reduces quality degradation. See the MedPsy Technical Report (Section 4.7) for the full quantization methodology, including the K-quants vs I-quants comparison and the per-bit-count imatrix ablation.

Two ways to read quality loss. Δ AVG (pts) is the absolute change in AVG Score vs the BF16/vLLM source-model baseline - the raw points lost. Δ AVG (rel %) is the relative change as a fraction of the baseline ((baseline − variant) / baseline). They convey complementary information: the absolute delta is the easiest "how much score did I actually lose?" reading, while the relative delta normalizes by baseline so quality degradation is comparable across models with different starting scores. AVG Score = mean of HealthBench Overall and Closed-Ended Average.

Quick Recommendation

Benchmark Results

The comparison uses the BF16 source model evaluated with vLLM as the reference baseline. Quantized GGUF variants were evaluated on the full closed-ended benchmark suite (7 medical benchmarks, averaged) and HealthBench (CompassJudger-2-32B-Instruct as judge), using the same benchmark protocol. The BF16 GGUF file is the unquantized GGUF export and has not been separately re-run with llama.cpp; since no quantization is applied, its performance is expected to match the BF16 source model aside from small backend or runtime differences. AVG Score is the average of HealthBench Overall and Closed-Ended Average.

HB = HealthBench; CE = Closed-Ended Average (7 medical benchmarks). Δ AVG (pts) is the absolute point change in AVG Score vs the BF16/vLLM source-model baseline (e.g. 72.27 - 71.46 = -0.81). Δ AVG (rel %) is the relative change as a fraction of the baseline (e.g. -0.81 / 72.27 = -1.12%). Δ Size is the relative file-size change vs BF16. ★ Recommended variants (best of class). ⚠ Not recommended due to significant quality degradation. AVG Score = (HealthBench Overall + Closed-Ended Average) / 2. Results averaged over 3 runs with generation parameters: temperature=0.6, top_k=20, top_p=0.95, max_output_tokens=16384. Quantized GGUF variants were evaluated with llama.cpp; the BF16 baseline was evaluated with vLLM. HealthBench evaluated using CompassJudger-2-32B-Instruct.

Key Findings

• Q8_0 is effectively lossless: -0.15 pts (-0.20% relative) AVG Score (72.13 vs 72.27) at 47% smaller (4.69 GB vs 8.83 GB), with no need for imatrix calibration.
• Q5_K_M is a recommended high-quality option: -0.29 pts (-0.40% relative) AVG Score at 64% smaller (3.16 GB), while matching BF16 on HealthBench and HealthBench Hard.
• Q4_K_M is the sweet spot: only -0.81 pts (-1.12% relative) AVG Score loss for a 69% size reduction (2.72 GB), comfortably fitting on high-end mobile and laptop devices.
• IQ3_M is exceptionally efficient at this scale: -1.50 pts (-2.07% relative) at 76% size reduction (2.13 GB). It even matches the BF16 HealthBench Hard score (58) - a remarkably strong compact result.
• IQ3_XXS is too aggressive: HealthBench Hard drops from 58 to 51 and AVG Score by -5.56 pts (-7.69% relative). Avoid this variant for medical use cases unless extreme size constraints leave no alternative.
• Even the worst quantization beats unquantized peers: IQ3_XXS still scores 64.42 closed-ended / 69 HealthBench, well above the unquantized Qwen3-4B-Thinking-2507 backbone (63.10 / 63.00) and unquantized MedGemma-1.5-4B-it (51.20 / 54.00).

How Quantized Variants Compare to Other Models

Even the most aggressive recommended quantization (IQ3_M at 2.13 GB) retains a substantial accuracy lead over the unquantized open-weight baselines in this size class:

Usage

llama.cpp

# Download the recommended file (Q4_K_M with imatrix - best size/quality for mobile/laptop)
huggingface-cli download qvac/MedPsy-4B-GGUF medpsy-4b-q4_k_m-imat.gguf --local-dir .

# Run interactively
./llama-cli -m medpsy-4b-q4_k_m-imat.gguf \
    -p "What are the common symptoms and first-line treatments for community-acquired pneumonia?" \
    --temp 0.6 --top-k 20 --top-p 0.95 -n 1024

QVAC SDK

These GGUF files are designed for deployment through the QVAC SDK, enabling fully private on-device inference on smartphones, tablets, and edge devices. See the QVAC documentation for integration guides.

# 1. Project setup
mkdir medpsy && cd medpsy
npm init -y && npm pkg set type=module

# 2. Install SDK + matching Bare runtime binary
#    (swap linux-x64 for: linux-arm64 | darwin-arm64 | darwin-x64 | win32-x64 | win32-arm64)
npm i @qvac/sdk bare-runtime-linux-x64

# 3. Authenticate with Hugging Face (one-time) and download the recommended quant
hf auth login
hf download qvac/MedPsy-4B-GGUF medpsy-4b-q4_k_m-imat.gguf --local-dir ./models

# 4. Run inference (streamed, GPU)
node --input-type=module -e '
import { loadModel, completion, unloadModel, VERBOSITY } from "@qvac/sdk";
import { resolve } from "node:path";
const id = await loadModel({
  modelSrc: resolve("./models/medpsy-4b-q4_k_m-imat.gguf"),
  modelType: "llamacpp-completion",
  modelConfig: { device: "gpu", ctx_size: 4096, verbosity: VERBOSITY.ERROR },
});
const r = completion({
  modelId: id,
  history: [{ role: "user", content: "First-line treatment for community-acquired pneumonia in 2 sentences." }],
  stream: true,
  generationParams: { temp: 0.6, top_p: 0.95, top_k: 20, predict: 2048 },
});
for await (const t of r.tokenStream) process.stdout.write(t);
const s = await r.stats;
console.log(`\n[${s.tokensPerSecond.toFixed(2)} tok/s, TTFT ${s.timeToFirstToken.toFixed(0)}ms, ${s.backendDevice}]`);
await unloadModel({ modelId: id });
'

Use and Limitations

Intended Use

MedPsy-4B-GGUF is intended as a starting point for developers and researchers building downstream healthcare applications involving medical text on-device. Developers are expected to validate, adapt, and make meaningful modifications to the model for their specific use cases.

Appropriate use cases include:

• On-device medical information retrieval for privacy-sensitive environments
• Building developer tools and prototypes for health-related applications running on edge devices
• Research on medical language understanding and reasoning under quantization

Always with appropriate disclaimers.

Limitations

[!WARNING] This model is NOT a substitute for professional medical judgment and the model outputs are NOT a substitute for proper clinical diagnosis. Always consult with a certified physician. Despite strong benchmark performance, MedPsy-4B is a compact 4B-parameter language model that will make errors. Quantization may further amplify rare-case failure modes that are not captured by aggregate benchmark numbers. Medical AI systems can produce outputs that appear confident and authoritative while being factually incorrect, incomplete, or clinically inappropriate.

Known limitations include:

• Hallucinations: The model may generate plausible-sounding but incorrect medical information.
• Quantization artifacts: Quantized models can occasionally produce subtly degraded outputs (rare-token drops, less stable formatting on long generations) that aggregate benchmarks may not capture. Effects grow at lower bit counts; we strongly recommend Q4_K_M or higher for production deployment, and avoid IQ3_XXS for any medical use case.
• English only: The model was trained and evaluated primarily in English. Performance in other languages is not validated.
• Text only: This model processes text inputs only. It cannot interpret medical images, lab results in non-text formats, or other modalities.
• No real-time knowledge: The model's knowledge has a training data cutoff and does not reflect the latest medical guidelines, drug approvals, or clinical evidence.
• Bias in training data: As with any model trained on synthetic and public medical data, biases in the source material may propagate to model outputs. Developers should validate performance across diverse patient populations, demographics, and clinical contexts.
• Not designed for emergencies: This model should never be used as the sole decision-making tool in emergency or life-threatening situations.

Safety Recommendations

When integrating this model into any application:

1. Always include visible disclaimers informing users that outputs are AI-generated and not a substitute for professional medical advice
2. Do not use for direct clinical diagnosis or treatment without oversight by qualified healthcare professionals
3. Monitor for harmful outputs and implement appropriate safety filters in production systems

Related Resources

• MedPsy Collection: All MedPsy models, datasets, and resources in one place
• MedPsy-4B (BF16): Full-precision source model
• MedPsy-1.7B-GGUF: Smaller GGUF sibling for smartphone-class deployment
• MedPsy Technical Report: Full quantization methodology and results (Section 4.7)
• QVAC SDK: On-device AI deployment framework
• llama.cpp: Inference engine and quantization toolchain

Citation

@article{medpsy2026,
  title={MedPsy: State-of-the-Art Medical and Healthcare Language Models for Edge Devices},
  author={Vitabile, Davide and Buffa, Alexandro and Nambiar, Akshay and Nazir, Amril},
  year={2026},
  url={https://huggingface.co/blog/qvac/medpsy},
  institution={Tether AI Research}
}

Copyright

We will take appropriate actions in response to notices of copyright infringement. If you believe your work has been used or copied in a manner that infringes upon your intellectual property rights, please email data-apps@tether.io identifying and describing both the copyrighted work and alleged infringing content.

Licensing

This model, which was trained as described in the MedPsy Technical Report, is licensed by Tether Data, S.A. de C.V. under the Apache 2.0 license for research and educational purposes. As described above, this model is a version of Qwen3-4B-Thinking-2507, which is also under the Apache 2.0 license.

As described above, a subset of the Genesis I and Genesis II datasets was used by the Baichuan-M3-235B model—which itself is also available under the Apache 2.0 license to generate synthetic data for training this model. The Genesis I dataset is made available under the CC-BY-NC 4.0 (Creative Commons Attribution-NonCommercial 4.0) license. The Genesis II dataset is also made available under the CC-BY-NC 4.0 license.