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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for niwrap-0.9.3.tar.gz
Algorithm Hash digest
SHA256 fc220ab5b31765c2a2bf057de02c6ef5715e1e2ef04783442d441c8a175ccbaa
MD5 4687af7e435ca2199aaeb9394112cb3d
BLAKE2b-256 1f648dd5f8baac33b081a8a4b2306fd5f5254adcfc8080896601f78c8d3ef9db

See more details on using hashes here.

File details

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

File metadata

  • Download URL: niwrap-0.9.3-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.12

File hashes

Hashes for niwrap-0.9.3-py3-none-any.whl
Algorithm Hash digest
SHA256 977b70b513522098097b87f4c839600b2865b75c68c7b055210bc6ebf4e421d9
MD5 509645848a433bcf7cb225327946cf2f
BLAKE2b-256 a41f7e79436ee0a7db2f6a54053e8397c519cc36956346c143b53c1957384b7a

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