Metadata-Version: 2.4
Name: mlx-reason-ct
Version: 0.3.3
Summary: Native MLX port of NVIDIA NV-Reason-CT for 3D CT reasoning on Apple Silicon
Project-URL: Homepage, https://github.com/MedMLX/MLX-Reason-CT
Project-URL: Repository, https://github.com/MedMLX/MLX-Reason-CT
Project-URL: Documentation, https://github.com/MedMLX/MLX-Reason-CT/blob/v0.3.2/docs/technical.md
Project-URL: Issues, https://github.com/MedMLX/MLX-Reason-CT/issues
Project-URL: Weights, https://huggingface.co/josand/MLX-Reason-CT
Author: Joseph Sandoval
License-Expression: Apache-2.0 AND MIT AND BSD-3-Clause AND LicenseRef-OpenMDW-1.1
License-File: LICENSE
License-File: THIRD_PARTY_NOTICES.md
Keywords: apple-silicon,ct,medical-imaging,mlx,nv-reason-ct
Classifier: Operating System :: MacOS :: MacOS X
Requires-Python: <3.15,>=3.13
Requires-Dist: huggingface-hub==1.23.0
Requires-Dist: jinja2==3.1.6
Requires-Dist: medmlx-core==0.2.4
Requires-Dist: mlx==0.32.4; sys_platform == 'darwin' and platform_machine == 'arm64'
Requires-Dist: nibabel==5.4.2
Requires-Dist: numpy==2.3.5
Requires-Dist: safetensors==0.8.0
Requires-Dist: scipy==1.18.1
Requires-Dist: tokenizers==0.22.2
Description-Content-Type: text/markdown

# MLX-Reason-CT

Generate reports and ask questions about 3D chest and abdomen CT, locally on Apple Silicon.

[Docs](https://github.com/MedMLX/MLX-Reason-CT/blob/main/docs/usage.md) · [MedMLX](https://github.com/MedMLX) · [Weights](https://huggingface.co/MedMLX/MLX-Reason-CT)

![MLX-Reason-CT example output](https://raw.githubusercontent.com/MedMLX/MLX-Reason-CT/main/docs/example.png)

*A generated report for a chest CT.*

| Input | Output |
| :--- | :--- |
| 3D CT · NIfTI | Reports and CT question answering |

**Apple Silicon · Metal · Python 3.13 / 3.14** · [uv](https://docs.astral.sh/uv/)

## Quick start

```bash
uv tool install --python 3.13 mlx-reason-ct
uvx --from huggingface_hub hf download MedMLX/MLX-Reason-CT \
  --local-dir models
```

```bash
mlx-reason-ct report \
  --input ct.nii.gz --model-dir models --output-dir outputs
```

Add `--anatomy-region abdomen` for abdominal CT, or `--prompt` to ask a question.

Allow more than 22.7 GB unified memory for the model, preprocessing and macOS. Crop whole-body scans to the chest or abdomen before running.

## License

Port contributions: [Apache-2.0](https://github.com/MedMLX/MLX-Reason-CT/blob/main/LICENSE). NVIDIA model materials and weights: OpenMDW-1.1. See [third-party notices](https://github.com/MedMLX/MLX-Reason-CT/blob/main/THIRD_PARTY_NOTICES.md).

For research and education. Outputs require human review.
