Metadata-Version: 2.4
Name: medicai
Version: 0.0.1
Home-page: https://github.com/innat/medic-ai
Author: innat
Author-email: innat.dev@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: Apache Software License
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: omegaconf
Requires-Dist: pandas
Requires-Dist: matplotlib
Requires-Dist: PyYAML
Requires-Dist: requests
Requires-Dist: typeguard
Requires-Dist: typing_extensions
Requires-Dist: tzdata
Requires-Dist: urllib3
Requires-Dist: scipy
Requires-Dist: tqdm
Provides-Extra: tensorflow
Requires-Dist: tensorflow[and-cuda]; extra == "tensorflow"
Provides-Extra: jax
Requires-Dist: jax[cuda12_local]; extra == "jax"
Provides-Extra: torch
Requires-Dist: torch==2.6.0+cu124; extra == "torch"
Provides-Extra: all
Requires-Dist: tensorflow[and-cuda]; extra == "all"
Requires-Dist: jax[cuda12_local]; extra == "all"
Requires-Dist: torch==2.6.0+cu124; extra == "all"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python


![](assets/logo.jpg)

[![Palestine](https://img.shields.io/badge/Free-Palestine-white?labelColor=green)](https://twitter.com/search?q=%23FreePalestine&src=typed_query)


![Static Badge](https://img.shields.io/badge/keras-3.9.0-darkred?style=flat) ![Static Badge](https://img.shields.io/badge/tensorflow-2.19.0-orange?style=flat) ![Static Badge](https://img.shields.io/badge/torch-2.6.0-red?style=flat)

**Medic-AI** is a [Keras](https://keras.io/keras_3/) based library designed for medical image analysis using machine learning techniques. It provides seamless compatibility with multiple backends, allowing models to run on `tensorflow`, `torch`, and `jax`.

**Note**: It is currently in its early stages and will undergo multiple iterations before reaching a stable release.

# Installation

```bash
!git clone https://github.com/innat/medic-ai
%cd medic-ai
!pip install . -q
%cd ..
```

# Guide

- 3D transformation
- [3D classification](https://www.kaggle.com/code/ipythonx/medicai-3d-image-classification)
- [3D segmentation](https://www.kaggle.com/code/ipythonx/medicai-3d-image-segmentation)

# Features

The `medicai` library provides a range of features for medical image processing, model training, and inference. Below is an overview of its key functionalities.

[**Image Transformations**](https://innat.github.io/medic-ai/transformations/manage-transformations/)

`medicai` includes various transformation utilities for preprocessing medical images:

- Basic Transformations:
  - `Resize` – Adjusts the image dimensions.
  - `ScaleIntensityRange` – Normalizes intensity values within a specified range.
  - `CropForeground` – Crops the image to focus on the region of interest.
  - `Spacing` – Resamples the image to a target voxel spacing.
  - `Orientation` – Standardizes image orientation.
- Augmentations for Robustness:
  - `RandRotate90` – Randomly rotates images by 90 degrees.
  - `RandShiftIntensity` – Randomly shifts intensity values.
  - `RandFlip` – Randomly flips images along specified axes.
- Pipeline Composition:
  - `Compose` – Chains multiple transformations into a single pipeline.

[**Models**](https://innat.github.io/medic-ai/models/manage-models/)

Currently, `medicai` focuses on 3D models for classification and segmentation:

- `SwinTransformer` – 3D classification task.
- `SwinUNETR` – 3D segmentation task.

**Inference**

- `SlidingWindowInference` – Processes large 3D images in smaller overlapping windows, improving performance and memory efficiency.


# Acknowledgements

This project is greatly inspired by [MONAI](https://monai.io/).

# Citation

If you use `medicai` in your research, please cite it using the metadata from our [`CITATION.cff`](https://github.com/innat/medic-ai/blob/main/CITATION.cff) file.
