Skip to main content

Active Learning Toolkit for Healthcare Imaging

Project description

MONAILabel

License CI Build Documentation Status codecov PyPI version

MONAILabel is a server-client system that facilitates interactive medical image annotation by using AI. It is an open-source and easy-to-install ecosystem that can run locally on a machine with one or two GPUs. Both server and client work on the same/different machine. However, initial support for multiple users is restricted. It shares the same principles with MONAI.

Brief Demo

Development in Progress. We will be actively working on this repository to add more features, fix issues, update docs, readme etc... as we make more progress. Wiki's, LICENSE, Contributions, Code Compliance, CI Tool Integration etc... Otherwise, it shares the same principles with MONAI.

Features

The codebase is currently under active development.

  • framework for developing and deploying MONAILabel Apps to train and infer AI models
  • compositional & portable APIs for ease of integration in existing workflows
  • customizable design for varying user expertise
  • 3DSlicer support

Installation

MONAILabel supports following OS with GPU/CUDA enabled.

Ubuntu

  # One time setup (to pull monai with nvidia gpus)
  docker run -it --rm --gpus all --ipc=host --net=host -v /rapid/xyz:/workspace/ projectmonai/monai:0.5.2
  
  # Install monailabel 
  pip install git+https://github.com/Project-MONAI/MONAILabel#egg=monailabel
  
  # Download MSD Datasets
  monailabel datasets # list sample datasets
  monailabel datasets --download --name Task02_Heart --output /workspace/datasets/
  
  # Download Sample Apps
  monailabel apps # list sample apps
  monailabel apps --download --name deepedit_left_atrium --output /workspace/apps/
  
  # Start Server
  monailabel start_server --app /workspace/apps/deepedit_left_atrium --studies /workspace/datasets/Task02_Heart/imagesTr

Windows

Prerequisites

Make sure you have python 3.x version environment with PyTorch + CUDA installed.

  • Install python
  • Install cuda (Faster mode: install CUDA runtime only)
  • python -m pip install --upgrade pip setuptools wheel
  • pip install torch==1.8.1+cu111 torchvision==0.9.1+cu111 torchaudio===0.8.1 -f https://download.pytorch.org/whl/torch_stable.html
  • python -c "import torch; print(torch.cuda.is_available())"

MONAILabel

  pip install git+https://github.com/Project-MONAI/MONAILabel#egg=monailabel
  monailabel -h
  
  # Download MSD Datasets
  monailabel datasets # List sample datasets
  monailabel datasets --download --name Task02_Heart --output C:\Workspace\Datasets
  
  # Download Sample Apps
  monailabel apps # List sample apps
  monailabel apps --download --name deepedit_left_atrium --output C:\Workspace\Apps
  
  # Start Server
  monailabel start_server --app C:\Workspace\Apps\deepedit_left_atrium --studies C:\Workspace\Datasets\Task02_Heart\imagesTr

Once you start the MONAILabel Server, by default it will be up and serving at http://127.0.0.1:8000/. Open the serving URL in browser. It will provide you the list of Rest APIs available.

3D Slicer

Refer 3D Slicer plugin for installing and running MONAILabel plugin in 3D Slicer.

Contributing

For guidance on making a contribution to MONAILabel, see the contributing guidelines.

Community

Join the conversation on Twitter @ProjectMONAI or join our Slack channel.

Ask and answer questions over on MONAILabel's GitHub Discussions tab.

Links

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

monailabel-weekly-0.1.dev2127.tar.gz (1.2 MB view details)

Uploaded Source

Built Distribution

monailabel_weekly-0.1.dev2127-py3-none-any.whl (1.3 MB view details)

Uploaded Python 3

File details

Details for the file monailabel-weekly-0.1.dev2127.tar.gz.

File metadata

  • Download URL: monailabel-weekly-0.1.dev2127.tar.gz
  • Upload date:
  • Size: 1.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.6

File hashes

Hashes for monailabel-weekly-0.1.dev2127.tar.gz
Algorithm Hash digest
SHA256 f511ecfd68dc42cea6cabbc50fea7949a6556b0ed9cda3a9c6bf1fbdf5ec3d3c
MD5 41fe43f7c546081d63afcbfd8e279a83
BLAKE2b-256 cdc8163fd2b48f8162c2593d4f693cd28e5d38c728ab957513a55b0bc96e1ff8

See more details on using hashes here.

File details

Details for the file monailabel_weekly-0.1.dev2127-py3-none-any.whl.

File metadata

  • Download URL: monailabel_weekly-0.1.dev2127-py3-none-any.whl
  • Upload date:
  • Size: 1.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.6

File hashes

Hashes for monailabel_weekly-0.1.dev2127-py3-none-any.whl
Algorithm Hash digest
SHA256 53e18117954fbb052ee4214a4044aecc6e1a9e95fa2f4b79f471fc1282ac5caa
MD5 db1e861f9b304e942afe140bb68051fc
BLAKE2b-256 6d31cec74af59312923c2ce8a34a1ee982aca5c7b75bd0ddc5f5510dcba9ff08

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page