ENHANCE-PET/LION has 32 GitHub stars and 6 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 00:20 UTC. Last push 2026-10-31.
Measured star growth
- in 24h
- 0
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
LION: Lesion Segmentation. Simplified.
Creative & MediaREADME.md
Original
LION
Fully automated tumor segmentation for FDG and PSMA PET scans
Quick Start
python -m venv lion-env
source lion-env/bin/activate # macOS / Linux
lion-env\Scripts\activate # Windows
pip install lionz
lionz -d /path/to/data -m fdg
That's it. Models download automatically on first run.
Requirements
- Python 3.11+
- 32GB RAM recommended
- GPU optional (NVIDIA CUDA or Apple Silicon MPS) - CPU works but slower
Installation
We recommend installing LION in a virtual environment to avoid dependency conflicts.
Using uv (recommended)
uv is a fast Python package manager that handles virtual environments automatically.
# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh # macOS/Linux
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # Windows
Install from PyPI:
uv venv lion-env
# Activate the environment
source lion-env/bin/activate # macOS / Linux
lion-env\Scripts\activate # Windows
uv pip install lionz
Install from source:
git clone https://github.com/ENHANCE-PET/LION.git
cd LION
uv sync
Using pip + venv
python -m venv lion-env
# Activate the environment
source lion-env/bin/activate # macOS / Linux
lion-env\Scripts\activate # Windows
python -m pip install lionz
Docker with NVIDIA GPUs
The LION Docker image targets CUDA 12.6. Use NVIDIA driver
560.28.03 or newer on Linux as the full CUDA 12.6 baseline. The host supplies the NVIDIA driver; it is not
installed inside the container. Locked uv installations on Linux and Windows
use the official PyTorch CUDA 12.6 index. Plain pip install lionz uses PyPI's
Torch build, which currently targets CUDA 13.0 on Linux and needs a compatible
580-series driver. To select CUDA 12.6 with pip, install the matching runtime first:
python -m pip install "torch==2.13.0" "torchvision==0.28.0" --index-url https://download.pytorch.org/whl/cu126
python -m pip install "lionz==1.1.0"
CUDA 12.6's driver guidance is in the NVIDIA release notes. The official PyTorch installation matrix lists this patched CUDA 12.6 runtime. GPU inference must be validated on the target hardware before promoting a Docker candidate. NVIDIA also documents limited CUDA 12.x minor-version compatibility on older drivers; this is not the validated LION deployment baseline.
When upgrading an existing model cache, run once with a writable model volume so LION can fetch and verify the pinned archive. The updated cache can then be mounted read-only. Failed verification or installation preserves the previous cache and raises an error.
docker run --rm --gpus all --shm-size=2g \
-v /path/to/data:/shared \
-v lionz-models:/usr/local/models \
lalithshiyam/lionz:1.1.0 \
-d /shared -m psma
LION stores downloaded models under
/usr/local/models/nnunet_trained_models, so the model volume persists across
container runs.
On a Slurm cluster with Singularity:
singularity exec --nv \
--bind /path/to/data:/shared \
--bind /path/to/models:/usr/local/models \
docker://lalithshiyam/lionz:1.1.0 \
lionz -d /shared -m psma
Input Data Structure
LION runs on PET input only. CT is not required for the current FDG and PSMA models.
data/
├── patient_001/
│ └── PT_scan.nii.gz # PET file with PT_ or PT- prefix
├── patient_002/
│ └── PT_scan.nii.gz
└── patient_003/
└── PT_scan.nii.gz
Rules:
- One folder per subject
- PET files must start with
PT_orPT- - CT files are not needed and are ignored by the current segmentation models
- Supports
.niiand.nii.gz - PET DICOM folders are also supported; modality is auto-detected from tags
Messy Data?
Use the lion-mcp server with Claude Code or Codex to organize chaotic DICOM/NIfTI dumps. See lion-mcp/README.md.
CLI Usage
# Basic
lionz -d /path/to/data -m fdg
# With SUV threshold
lionz -d /path/to/data -m fdg -t 2.5
# Generate MIP preview
lionz -d /path/to/data -m fdg -g
# Parallel processing (multiple subjects)
lionz -d /path/to/data -m fdg -p 4
# All options
lionz -d /path/to/data -m fdg -t 2.5 -g -p 4
Options:
| Flag | Description |
|---|---|
-d |
Input directory containing subject folders |
-m |
Model name: fdg or psma |
-t |
SUV threshold (requires SUV-calibrated input) |
-g |
Generate rotational MIP GIF |
-p |
Number of parallel jobs |
-h |
Show help |
Library Usage
import lionz
# From file path
result = lionz.lion('/path/to/PT_scan.nii.gz', 'fdg')
# From SimpleITK image
import SimpleITK as sitk
img = sitk.ReadImage('/path/to/PT_scan.nii.gz')
seg = lionz.lion(img, 'fdg') # Returns SimpleITK.Image
# From numpy array
import numpy as np
array = np.load('pet_data.npy')
spacing = (2.0, 2.0, 2.0)
seg = lionz.lion((array, spacing), 'fdg') # Returns np.ndarray
# With options
result = lionz.lion(
'/path/to/PT_scan.nii.gz',
'fdg',
output_dir='/path/to/output',
accelerator='mps', # 'cpu', 'cuda', or 'mps'
threshold=2.5
)
Important: Wrap in if __name__ == '__main__': to avoid multiprocessing issues:
import lionz
if __name__ == '__main__':
lionz.lion('/path/to/PT_scan.nii.gz', 'fdg')
Models
| Tracer | Model | Training Data | Status |
|---|---|---|---|
| FDG | fdg |
5,235 patients | Stable |
| PSMA | psma |
2,046 patients | Stable |
Output Structure
patient_001/
├── PT_scan.nii.gz # Original PET input
└── lionz-2024-01-15-10-30-00/
├── segmentations/
│ ├── PT_scan_tumor_seg.nii.gz # Tumor mask
│ └── patient_001_rotational_mip.gif # If -g flag used
└── stats/
└── patient_001_metrics.csv # Volume, SUV metrics
Platform Support
| Platform | Accelerator | Status |
|---|---|---|
| Linux | CUDA | Fully supported |
| Linux | CPU | Supported (slower) |
| macOS (Apple Silicon) | MPS | Fully supported |
| macOS (Intel) | CPU | Supported (slower) |
| Windows | CUDA | Fully supported |
| Windows | CPU | Supported (slower) |
For AI Agents
LION provides an MCP server for organizing messy medical imaging data. Install and configure:
cd lion-mcp && pip install -e .
Add to .mcp.json:
{
"lion-mcp": {
"type": "stdio",
"command": ".venv/bin/lion-mcp"
}
}
Available MCP tools:
scan_directory- Scan for DICOM/NIfTI files, extract metadataread_dicom_header- Read full DICOM tagsorganize_for_lion- Reorganize files into LION structurevalidate_structure- Check if directory is LION-readyget_lion_requirements- Get structure documentation
Telemetry
LION collects anonymous usage statistics to help us understand how the tool is used and prioritize development. This is completely optional.
What we collect: version, model used, platform, accelerator type, number of subjects, success/failure
What we DON'T collect: file paths, patient data, IP addresses, any identifiable information
Opt-out:
export LIONZ_TELEMETRY=0
Citation
DOI: 10.5281/zenodo.12626789
License
Apache 2.0.
Contributors
Part of the ENHANCE.PET initiative.