Skip to main content

Neuroimaging wrappers.

Project description

⚠️ Important Notice: This is a very early release of niwrap. We do not recommend using niwrap in 'production' at this stage unless you are willing to debug, fix, and contribute descriptors.

niwrap

🧠 Python wrappers for neuroimaging command-line tools

GitHub stars PyPI stability-stable MIT License pages Preprint Discord

🚀 Quick Start

from niwrap import fsl

# Brain extraction using FSL's BET
bet_output = fsl.bet(
    infile="input_image.nii.gz",
)

📦 Installation

Install the stable version from PyPI:

pip install niwrap

Or install the development version:

pip install -r https://raw.githubusercontent.com/styx-api/niwrap-python/main/requirements_remote.txt

🧰 Supported Tools

Package Default Version API Coverage
AFNI 24.2.06 565/611 (92.5%)
ANTs 2.5.3 72/113 (63.7%)
Convert3D 1.1.0 4/4 (100% 🎉)
dcm2niix 1.0.20240202 1/1 (100% 🎉)
FastSurfer 2.3.3 1/1 (100% 🎉)
FreeSurfer 7.4.1 696/789 (88.2%)
FSL 6.0.4 243/311 (78.1%)
Greedy 1.0.1 1/1 (100% 🎉)
MRTrix3 3.0.4 115/121 (95.0%)
MRTrix3Tissue 5.2.8 1/1 (100% 🎉)
NiftyReg 1.4.0 7/7 (100% 🎉)
Connectome Workbench 2.1.0 203/203 (100% 🎉)

🛠 Usage Examples

Usage examples and tutorials can be found in the Styx book.

🔧 Development

All code in this package is automatically generated by Styx.

🤝 Contributing

We welcome contributions! Please see our Contribution Guide for more details.

📄 License

The niwrap Python package, including all wrapper code, is licensed under the MIT License. See the LICENSE file for more details.

⚠️ Important Notice: While niwrap provides convenient Python wrappers, it does not include or distribute the actual neuroimaging tools. Each tool wrapped by niwrap (e.g., FSL, AFNI, ANTs) is subject to its own license. Users of niwrap must ensure they comply with the licenses of the underlying tools they use. The MIT License of niwrap applies only to the wrapper code, not to the tools themselves.

🙋‍♀️ Getting Help

The Styx book aims to be a starting point for new users.

If you encounter any problems or have any questions, please open an issue on our GitHub repository.

📚 Citation

If you use NiWrap in your research, please consider citing:

@article {rupprecht2025styx,
	author = {Rupprecht, Florian JM and Kai, Jason and Shrestha, Biraj and Giavasis, Steven and Xu, Ting and Glatard, Tristan and Milham, Michael P and Kiar, Gregory},
	title = {Styx: A multi-language API Generator for Command-Line Tools},
	elocation-id = {2025.07.24.666435},
	year = {2025},
	doi = {10.1101/2025.07.24.666435},
	publisher = {Cold Spring Harbor Laboratory},
	URL = {https://www.biorxiv.org/content/early/2025/07/30/2025.07.24.666435},
	eprint = {https://www.biorxiv.org/content/early/2025/07/30/2025.07.24.666435.full.pdf},
	journal = {bioRxiv}
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

niwrap-0.8.11.tar.gz (3.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

niwrap-0.8.11-py3-none-any.whl (4.0 kB view details)

Uploaded Python 3

File details

Details for the file niwrap-0.8.11.tar.gz.

File metadata

  • Download URL: niwrap-0.8.11.tar.gz
  • Upload date:
  • Size: 3.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for niwrap-0.8.11.tar.gz
Algorithm Hash digest
SHA256 8b6d377cfb5761ae57c47cf35bc7bde8223e3e4411097cc1904f7bd11fc4212a
MD5 80c497ff25eb2fcc36d096fb46970b0e
BLAKE2b-256 43f66be01b513007b12f1adb585af87aed2e0447042953de9ac86a1e99f66108

See more details on using hashes here.

File details

Details for the file niwrap-0.8.11-py3-none-any.whl.

File metadata

  • Download URL: niwrap-0.8.11-py3-none-any.whl
  • Upload date:
  • Size: 4.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for niwrap-0.8.11-py3-none-any.whl
Algorithm Hash digest
SHA256 dc36b9e13d19154e8fd990d00b1ca25857a5a7e676a6960901ef528482be56d7
MD5 c5172a54e644acb04750bbe45f0c9a17
BLAKE2b-256 95ddb71687c96f26bd4f2cff85d30ca06a2e5d0593ab6faec5b831bf43ae91fa

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page