Ecosystem#

KonfAI is the core, but several packages and tools sit around it. This page maps how they relate and — importantly — what is shipped versus what is external or experimental, so you know what you can rely on today.

The map#

KonfAI system map released path experimental edge

Resolved YAML and medical data enter the KonfAI core. KonfAI Apps and KonfAI MCP both build on the core; MCP also operates Apps. Hugging Face artifacts feed Apps and the task-specific command-line tools. Slicer clients operate Apps and ImpactReg, while ONNX to konfai-rs remains experimental.

Research contract Resolved YAML + medical data

Data, transforms, models, losses, metrics, and workflow intent.

Published artifacts Hugging Face Hub

App configs, checkpoints, metadata, and demo datasets.

published
Execution foundation · PyPI konfai

One declarative, patch-native engine for medical-imaging workflows.

TRAINPREDICTIONEVALUATION
Application runtime · PyPI konfai-apps

Resolve local or Hub Apps and run the same workflow through Python, CLI, REST, or SSE logs.

Agent runtime · PyPI konfai-mcp

Operates core workflows and Apps through structured scientific tools.

STDIOSSEHTTP
App surfaces Python · CLI · REST

Local and remote execution share one App contract.

Task CLIs · PyPI Five ready-to-run entry points

ImpactSynth · ImpactSeg · ImpactReg · MRSegmentator · TotalSegmentator

Agent clients Scientific automation

Inspect, configure, validate, execute, compare, and resume.

External clinical client SlicerKonfAI

Runs KonfAI Apps from 3D Slicer.

external
External registration client SlicerImpactReg

Drives the complete ImpactReg orchestrator.

external
Portable edge ONNX → konfai-rs

Native and WebAssembly inference path.

experimental
One execution model, several operating surfaces. Solid routes show released dependencies and orchestration paths; the dotted route is experimental.

Released platform#

Piece

Status

What it is

konfai

✅ Shipped (PyPI)

The core framework: config-by-reflection, lazy patch-based data, model graphs, and the three YAML workflows. This is what the rest of this documentation is about.

konfai-apps

✅ Shipped (PyPI, own CI)

Packages a mature workflow as a reusable app — see Using KonfAI Apps.

konfai-mcp

✅ Shipped (PyPI, own CI)

Operates KonfAI workflows and Apps through structured tools for dataset inspection, config authoring and validation, job execution, monitoring, metrics, and comparison — see Agent workflows (MCP server).

App bundles (apps/)

✅ Shipped (thin wrappers)

Ready-to-use CLI shims: impact-synth-konfai, impact-seg-konfai, mrsegmentator-konfai, totalsegmentator-konfai. Config + weights live on Hugging Face and download on first run.

impact-reg-konfai

🟡 Shipped, heaviest

A full multi-preset registration orchestrator (Elastix + the IMPACT semantic metric), not a thin wrapper. The most moving parts of the five.

Demo data & models (HF)

✅ Published

VBoussot/konfai-demo (demo dataset), plus per-app model repos (ImpactSynth, ImpactSeg, TotalSegmentator-KonfAI, MRSegmentator-KonfAI, ImpactReg) and impact-torchscript-models (the SAM2.1 backbone behind IMPACTSynth).

Challenge repos

✅ External

Top-ranking MICCAI-challenge projects built on KonfAI (SynthRAD 2025 T1/T2, TrackRAD 2025, Panther, CURVAS, CURVAS-PDACVI). Referenced from the README; not in this tree.

Ready-to-use apps#

App CLI

Task

Modality

Models

impact-synth-konfai synthesize

Synthetic CT (sCT)

MR → CT, CBCT → CT

MR, CBCT

impact-seg-konfai segment

Multimodal body segmentation (11 labels)

CBCT / MR / CT

body

mrsegmentator-konfai segment

Whole-body MRI segmentation

MRI

folds 1–5

totalsegmentator-konfai segment

Whole-body CT/MRI segmentation

CT / MRI

total, total_mr, 3 mm variants

impact-reg-konfai register

Multimodal deformable registration

MR/CT, CBCT/CT

presets

Each also exposes eval and (except TotalSegmentator) uncertainty; the thin wrappers add pipeline. See Using KonfAI Apps for how to run them and CLI reference for the full flag reference.

External clients and experimental edge#

Piece

Status

Notes

SlicerKonfAI

✅ External GUI

A 3D Slicer client of the konfai-apps CLI/server, covered by API, CLI, and JSON contract tests in the Apps package.

SlicerImpactReg

✅ External GUI

A dedicated 3D Slicer client for the complete impact-reg-konfai registration orchestrator.

ONNX export → konfai-rs

🧪 Experimental

konfai/export.py produces ONNX + a manifest for a planned portable (native/WASM) inference engine. Python-API-only, single static-shape head, feed-forward models only. See Python API (apps).

Note

Trust model. Resolving a konfai-apps app copies and imports its .py files (arbitrary code) and pip-installs its requirements.txt by default (opt out with KONFAI_APPS_INSTALL_REQUIREMENTS=0), so only resolve apps from sources you trust — see Python API (apps).

See also#