beautiful-brains 0.0.4a0

Create figures and images from NIfTI images, masks, and label maps.

Beautiful Brains

Beautiful-Brains creates notebook-friendly NIfTI figures from intensity images, masks, and label maps.

Beautiful-Brains provides a Python toolkit for loading, smoothing, transforming, coregistering, slicing, and compositing NIfTI images in Jupyter notebooks and Python scripts. Images are read with NiBabel, processed with NumPy and SciPy, and rendered with Pillow. Registration, masking, and bias-field correction are performed with ANTsPy.

Beautiful-Brains was created from a collection of personal scripts. These tools saved me a lot of time making figures for presentations that are visually pleasing. I also used these features to create lightbox-style QC images for automated neuroimaging pipelines.

Installation

Install the current Beautiful-Brains release with pip:

pip install beautiful-brains

Usage

See the demonstration notebook.

AI Disclaimer

This project originated as a collection of human-coded scripts. Claude Code (Sonnet 4.6) and Codex (GPT-5.5) were used to convert a working codebase into a Python package. These AI tools restructured and rewrote nearly everything. Future development will continue using AI-assisted coding tools.

Support

Please send questions, bug reports, and feature requests to the issue tracker.

Documentation will be expanded after the project leaves alpha.

License

Beautiful-Brains is licensed under the terms of the GNU General Public License version 3. For more information, see the LICENSE file. :::