Skip to content
Other

MuscleMap v1.4 for MLX

сегментация мышц и костей на МРТ и КТ для Mac

2 min readupdated

Модель автоматически размечает 113 мышечных и костных структур на трёхмерных медицинских снимках форматов NIfTI (МРТ и КТ). Это конвертация весов проекта MuscleMap v1.4 под фреймворк MLX и графический движок Metal для локального запуска на чипах Apple Silicon. В основе лежит компактная архитектура 2D MONAI UNet (нейросеть для сегментации изображений) с 1 входным и 114 выходными каналами. Инструмент пригодится исследователям и разработчикам медицинских сервисов на macOS, позволяя обходиться без PyTorch и видеокарт NVIDIA.

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

  • Размечает 113 анатомических структур с сохранением оригинальных ID, названий, сторон и областей тела в labels.json.
  • Работает нативно на Apple Silicon через MLX и Metal, не требуя громоздких зависимостей.
  • Точная конвертация всех 46 тензоров в формате float32 без дообучения и квантования.
  • Восстанавливает логиты до исходной сетки снимка и оставляет крупнейший связный компонент для каждой метки.

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

  • Автоматизировать разметку мышечных и костных тканей на 3D-снимках МРТ и КТ в медицинских исследованиях.
  • Интегрировать быстрый локальный анализ NIfTI-файлов в софт и пайплайны под macOS на базе Apple Silicon.
  • Проводить количественную оценку мышц всего тела (Whole-Body Quantitative MRI) без отправки данных в облако.

Пример

musclemap-mlx segment --input scan.nii.gz --model-dir /path/to/this/bundle --output-dir out
Подробнее Параметры: ~0.03B (46 тензоров в float32), архитектура 2D MONAI UNet.
Верификация: на тестовых объёмах TotalSegmentator CT (122x101x30) и MRI (117x91x20) финальные воксели полностью совпали с эталоном на PyTorch 2.4.1 / MONAI 1.3.2 (макс. ошибка логитов 9.92e-5 и 1.03e-4).
Ограничения: при сравнении результатов важно использовать одинаковый размер чанков, так как он влияет на нормализацию.
Лицензия: MIT.
Discuss Telegram 0 52

Will it run?

Runs in F32

Fits without quantisation.

  • F32weights 0.1 GB · ready files0.6 GB
  • BF16weights 0.0 GB0.6 GB
  • FP8 / INT8recommendedweights 0.0 GB0.5 GB
  • 4-bitweights 0.0 GB0.5 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 · F32 — from RTX 2060

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

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

Run it on Massed Compute

The script downloads the model to the rented machine. How to run it is in the model card.

  1. 1. Rent a machine with a fitting GPU

    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.

    # MedMLX/musclemap-mlx
    mkdir -p ~/models
    curl -LsSf https://astral.sh/uv/install.sh | sh
    source "$HOME/.local/bin/env"
    uv tool install "huggingface_hub[cli]"
    hf download MedMLX/musclemap-mlx --local-dir ~/models/musclemap-mlx
    # The model is in ~/models. How to run it is in the model card (link above).
    Add more LoRAs to musclemap-mlx
  3. 3. Use it

    The model is in ~/models. How to run it is in the model card (link above).

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.

Model family

New posts about versions of musclemap-mlx (quants, finetunes, LoRAs) will show up under the bell.

No known relatives of this model yet. All derivatives on Hugging Face

About the model

MedMLX/musclemap-mlx
Author
MedMLX
Category
Other
Released
Posted

On NeyroLearn

Hugging Face

520

Ask AI about this model

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

Comments