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.9.1.tar.gz (3.6 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.9.1-py3-none-any.whl (4.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for niwrap-0.9.1.tar.gz
Algorithm Hash digest
SHA256 aff6c5f5fa3451937fff02dbd63fa8b28c6fd33fadc0d5e5b47e591c349e0d64
MD5 8a0557b6fb8c312406a783b256ebc230
BLAKE2b-256 bf576d156f74e1b657160738fb41b091cd9374a0bc4645e091515c4921790cd3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: niwrap-0.9.1-py3-none-any.whl
  • Upload date:
  • Size: 4.2 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.9.1-py3-none-any.whl
Algorithm Hash digest
SHA256 498aef3ddbf1de93e02a9425ffa873e69e4711d346b88cb463a1aa40d5a8623c
MD5 6d6fd3d8ddd3d863c774c779d1e81c69
BLAKE2b-256 a984c434d2859e2dddcdf385fbfb71424be13a495b81b953d7a9ad06d3bbd1eb

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