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.9.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.9-py3-none-any.whl (4.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: niwrap-0.8.9.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.9.tar.gz
Algorithm Hash digest
SHA256 05fc6ebdf13635e2ecc3db73c8b6d9b368326a189d598f2a9cbc413065398f24
MD5 6f7b062de481bec68ffc0f9a344bbc60
BLAKE2b-256 d7b74ae92371dc4e8b19736aa945a449969aeba425428944b029b7334823bf61

See more details on using hashes here.

File details

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

File metadata

  • Download URL: niwrap-0.8.9-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.9-py3-none-any.whl
Algorithm Hash digest
SHA256 4c4fb9606e002738a932441b83777af3b96fe71311ed7324ed2a506962d62447
MD5 92802eebea0187e260fff6e38a650c50
BLAKE2b-256 107eea1b70cdfe8359686c277d388614c26c1e3fc6613b7ec9cfd27dcb7a3de4

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