README.md

---
license: cc-by-nc-4.0
library_name: mlx
tags:
- mlx
- native-mlx
- apple-silicon
- medical-imaging
- x-ray
- segmentation
- noncommercial
- research
language:
- en
inference: false
pipeline_tag: image-segmentation
base_model: VictorButoi/flexray
---

<img src="https://huggingface.co/MedMLX/flexray-mlx/resolve/main/banner.png" alt="MedMLX — Segment. RADIOGRAPHS / FLEXRAY" width="100%">

# FleXray · Radiographs

Segment anatomical structures in radiographs with the released FleXray flux0375 member.

[GitHub](https://github.com/MedMLX/flexray-mlx) · [Files](https://huggingface.co/MedMLX/flexray-mlx/tree/main) · [Docs](https://github.com/MedMLX/flexray-mlx/blob/main/README.md#quick-start)

| Input | Output |
| :--- | :--- |
| Radiograph | Anatomical segmentation |

**Apple Silicon · Metal · Python 3.13 / 3.14**

## Quick start

```bash
uv venv --python 3.13
source .venv/bin/activate

repo="https://github.com/MedMLX/flexray-mlx"
release="$repo/releases/download/v0.2.1"
uv pip install "$release/flexray_mlx-0.2.1-py3-none-any.whl"
uv tool install huggingface-hub

hf download MedMLX/flexray-mlx --local-dir models
```

Replace the example input paths with your own files.

```python
from flexray_mlx.medmlx import run

result = run(
    image_path='chest.png',
    weights_path='models',
    output_dir='outputs',
    label_name='lungs',
    ensemble=False,
)
print(result["outputs"])
```

Includes the `flux0375` member. Keep `ensemble=False`.

## Use & license

For research and education. Not validated for clinical use.

Weights: [CC-BY-NC-4.0 · noncommercial](https://huggingface.co/MedMLX/flexray-mlx/blob/main/LICENSE). [Notices](https://huggingface.co/MedMLX/flexray-mlx/blob/main/NOTICE).

## Paper references

- [Original model: FleXray: Universal Clinical X-ray Segmentation](https://arxiv.org/abs/2609.26756).