Skip to content
Language models

Meditor-3-4B-MoE

компактная MoE-модель с 8 экспертами на базе Qwen3-4B

3 min readupdated

Meditor-3-4B-MoE от автора Yo-Purple — языковая модель (LLM) с нестандартной архитектурой MoE (Mixture-of-Experts — смесь экспертов, где под запрос подключаются нужные модули). В основе лежит целая модель Qwen3-4B (4,02 млрд параметров), дополненная 8 специализированными LoRA-адаптерами (небольшими надстройками над базовой моделью) и компактным роутером PromptRouter на 2,90 млн параметров. Главная особенность в том, что роутер анализирует промпт ещё до генерации первого токена, выбирает от 1 до 3 профильных экспертов и динамически подмешивает их веса во все 36 слоёв сети. Подойдёт разработчикам и энтузиастам, которым нужна универсальная локальная модель для математики, кода, логики и строгого следования инструкциям на видеокартах с 8 ГБ видеопамяти.

Ключевые особенности

  • Динамическая маршрутизация до декодирования: PromptRouter оценивает скрытые состояния запроса и активирует 1–3 эксперта из 8 доступных, задействуя от 4,04B до 4,07B параметров из общих 4,16B.
  • 8 узкопрофильных экспертов (rank-8 LoRA): отдельные модули отвечают за математику (math), дедуктивную логику (logic), код (code), естественные науки и фактчек (science), жёсткие ограничения формата (constraints), стратегию (strategy), креатив (creative) и краткие ответы без лишних рассуждений (crisp).
  • Длинный контекст и низкий расход памяти: поддерживается окно контекста до 40 960 токенов, а пиковое потребление VRAM при генерации в режиме bf16_low_vram составляет 5,43 GiB (менее 3,5 ГБ при запуске в 4-битном режиме).
  • Заметный прирост над базой: в тесте Probe10 модель набирает 7,02 балла из 10 против 4,28 у исходной Qwen3-4B (+2,74 балла).

Что можно сделать

  • Поднять локальный чат-сервер с API: в репозиторий включены скрипты server.py, веб-интерфейс и терминальный чат chat.py с OpenAI-совместимым эндпоинтом /v1/chat/completions для подключения к своим пет-проектам и IDE.
  • Решать задачи на логику, код и строгий формат вывода: использовать модель для генерации JSON по схеме, пошаговых вычислений и алгоритмических задач благодаря профильным LoRA-экспертам.
  • Запускать на бюджетных GPU или в llama.cpp: запустить PyTorch-версию на карте уровня RTX 4060 8 ГБ (в том числе через --backend pytorch_4bit) либо взять совместимую GGUF-сборку Meditor-3-4B-Universal для LM Studio.

Пример

import torch
from transformers import AutoModelForCausalLM, AutoTokenizer

repo_id = "Yo-Purple/Meditor-3-4B-MoE"
tok = AutoTokenizer.from_pretrained(repo_id)
model = AutoModelForCausalLM.from_pretrained(repo_id, trust_remote_code=True)

messages = [{"role": "user", "content": "Solve x^2 - 7x + 12 = 0 briefly."}]
prompt = tok.apply_chat_template(messages, tokenize=False, add_generation_prompt=True, enable_thinking=False)
inputs = tok(prompt, return_tensors="pt")

with torch.no_grad():
    out = model.generate(**inputs, max_new_tokens=128, do_sample=False, pad_token_id=tok.eos_token_id)

print(tok.decode(out[0, inputs["input_ids"].shape[1]:], skip_special_tokens=True))
ПодробнееБенчмарк UniBench-100: средний балл 7,31/10 (1-е место из 36 прогонов серии), Pass Rate 69,0%, лучший результат в критическом мышлении (9,09/10) и креативе (8,38/10).
Тесты на RTX 4060 8 GB: загрузка за 5,26 с, пик 5,432 GiB зарезервированной VRAM в bf16_low_vram, скорость 35,7 tok/s (для Q8_0 базы с динамическими LoRA).
Требования и ограничения: для загрузки через transformers требуется флаг trust_remote_code=True; вес файлов в BF16 на диске — 7,75 GiB; лицензия Apache 2.0.
Примеры
Discuss Telegram 0 25

Will it run?

Runs in BF16

Fits without quantisation.

  • BF16weights 7.5 GB · ready files9.2 GB
  • FP8 / INT8recommendedweights 3.7 GB5.5 GB
  • 4-bitweights 2.1 GB3.8 GB

Tip: go 8-bit.FP8 / INT8 is within about a percent of full precision in quality, takes half the memory and runs faster on RTX 40/50 and H100. Full precision only pays off for fine-tuning.

What to get for this model

Massed ComputeOpen Massed Compute

Your own GPU: FP8 / INT8 — from RTX 2060 · BF16 — from RTX 3080

Massed Compute hourly prices, November 2026. The discounted price applies with the coupon at checkout.

Language models: with a 8192-token context.

Estimate: weights plus working memory. Long videos, high resolutions and long contexts need more.

Run it on Massed Compute

A ready script for the machine we advise above: paste it and the model downloads and starts.

  1. 1. Rent A30

    $0.26 an hour with the coupon. Pick the Ubuntu image when you create the machine.

    Open Massed Compute
  2. 2. Paste the script into the machine's terminal

    Connect over SSH (the Massed Compute panel shows the command) or open a terminal on the machine's desktop.

    HF_TOKEN / CIVITAI_TOKENThe script starts with token lines: paste yours between the quotes. The Hugging Face token is for gated models, the Civitai one for Civitai models.

    # Yo-Purple/Meditor-3-4B-MoE — A30, FP8 / INT8
    # NVIDIA driver: CUDA 13 needs 580+. If older or missing, the current nvidia-open is installed (keep yours: KEEP_DRIVER=1)
    DRV=$(nvidia-smi --query-gpu=driver_version --format=csv,noheader 2>/dev/null | head -1 | cut -d. -f1)
    case "$DRV" in ""|*[!0-9]*) DRV=0 ;; esac
    if [ "$DRV" -lt 580 ] && [ -z "${KEEP_DRIVER:-}" ]; then
      . /etc/os-release && \
      curl -fsSLO "https://developer.download.nvidia.com/compute/cuda/repos/ubuntu${VERSION_ID//./}/x86_64/cuda-keyring_1.1-1_all.deb" && \
      sudo dpkg -i cuda-keyring_1.1-1_all.deb && rm -f cuda-keyring_1.1-1_all.deb && \
      sudo apt-get update && \
      sudo DEBIAN_FRONTEND=noninteractive apt-get install -y nvidia-open || \
      { echo "Could not install the NVIDIA driver: see the error above. To keep the current one, run with KEEP_DRIVER=1."; exit 1; }
      echo "NVIDIA driver updated. Reboot the machine (sudo reboot) and run this same script again."
      exit 0
    fi
    curl -LsSf https://astral.sh/uv/install.sh | sh
    source "$HOME/.local/bin/env"
    uv venv ~/vllm --python 3.12 && source ~/vllm/bin/activate
    uv pip install vllm
    vllm serve Yo-Purple/Meditor-3-4B-MoE --max-model-len 8192 --quantization fp8
    Add more LoRAs to Meditor-3-4B-MoE
  3. 3. Use it

    The server listens on port 8000 and speaks the OpenAI API: http://localhost:8000/v1 on the machine. From your computer: ssh -L 8000:localhost:8000 user@machine-IP.

Stop the machine in the panel when you are done: it bills by the minute while it runs.

How to speed it up

Picked for this model type. Choose your hardware above to see what fits you exactly.

  • FlashAttention 44.0.0b40from November 18, 2026new release

    fastest exact attention on B200

    Kernels for Blackwell (beta). Exact attention without quantisation — fine for everything, LLMs included.

    How to enable: pip install flash-attn-4; vLLM and SGLang pick it up themselves.

    Earlier generations (2)
    • FlashAttention 3 — The Hopper (H100/H200) version with FP8.
    • FlashAttention 2 — The standard for RTX 30/40/50 and A100: exact attention without the memory cost of long contexts.
  • torch.compile2.15.0from October 28, 2026new release

    10–30% for free

    Compiles the model for your GPU. Slower first run, faster afterwards.

    How to enable: model = torch.compile(model); in ComfyUI the TorchCompileModel node.

  • MTP (multi-token prediction)0.34.0from November 16, 2026new release

    1.5–2× generation speed

    If the model has MTP layers (DeepSeek-V3/R1, Qwen3-Next, GLM, MiMo and others), it predicts several tokens per step itself.

    How to enable: vLLM / SGLang: --speculative-config '{"method": "mtp", "num_speculative_tokens": 1}'. Check the model card.

    Earlier generations (2)
    • EAGLE-3 — Speculative decoding with a small draft head. For models without their own MTP layers.
    • EAGLE-2 / Medusa — Earlier draft-head generations. Still work if that is all you find.
  • FP8 KV cache0.34.0from November 16, 2026new release

    2× more context in the same memory

    Keeps the attention cache in 8 bits, so long contexts fit where they did not.

    How to enable: vLLM: --kv-cache-dtype fp8; llama.cpp: -ctk q8_0 -ctv q8_0.

  • vLLM / SGLang0.34.0from November 16, 2026new release

    many times more tokens/s on a server

    Server engines: batching, FlashAttention, FP8 and speculative decoding out of the box.

    How to enable: vllm serve <model> — an OpenAI-compatible API.

    Earlier generations (1)
    • llama.cpp — GGUF models on any GPU, Mac or even CPU; some layers can stay in RAM.

Model family

  1. Qwen3-4B-Basefamily root
  2. Qwen3-4B
  3. Meditor-3-4B-MoE

New posts about versions of Qwen3-4B-Base (quants, finetunes, LoRAs) will show up under the bell.

Quantised versions 12All on Hugging Face
Fine-tunes 12All on Hugging Face
LoRAs and adapters 2All on Hugging Face
Merges 1All on Hugging Face

About the model

Yo-Purple/Meditor-3-4B-MoE
Author
Yo-Purple
Category
Language models
Released
Posted

On NeyroLearn

Hugging Face

250

Ask AI about this model

Answered by Gemini 4 · the chat is kept only in this tab

Comments

Language models

Meditor-2

Meditor-2
Computer vision

MedJev-4B

MedJev-4B