Modnet

🚀 wuchendi/MODNet (Matting Objective Decomposition Network)

Trimap-Free Portrait Matting in Real Time

This project provides a real - time portrait matting solution without the need for a trimap. It can be used for various vision - related tasks such as background removal and portrait matting.

🚀 Quick Start

Usage with Transformers.js

First, install the @huggingface/transformers library from PNPM:

pnpm add @huggingface/transformers

Then, use the following code to perform portrait matting with the wuchendi/MODNet model:

/* eslint-disable no-console */
import { AutoModel, AutoProcessor, RawImage } from '@huggingface/transformers'

async function main() {
  try {
    console.log('üöÄ Initializing MODNet...')

    // Load model
    console.log('📦 Loading model...')
    const model = await AutoModel.from_pretrained('wuchendi/MODNet', {
      dtype: 'fp32',
      progress_callback: (progress) => {
        // @ts-ignore
        if (progress.progress) {
          // @ts-ignore
          console.log(`Model loading progress: ${(progress.progress).toFixed(2)}%`)
        }
      }
    })
    console.log('‚úÖ Model loaded successfully')

    // Load processor
    console.log('üîß Loading processor...')
    const processor = await AutoProcessor.from_pretrained('wuchendi/MODNet', {})
    console.log('‚úÖ Processor loaded successfully')

    // Load image from URL
    const url = 'https://res.cloudinary.com/dhzm2rp05/image/upload/samples/logo.jpg'
    console.log('🖼️ Loading image:', url)
    const image = await RawImage.fromURL(url)
    console.log('‚úÖ Image loaded successfully', `Dimensions: ${image.width}x${image.height}`)

    // Pre-process image
    console.log('🔄 Preprocessing image...')
    const { pixel_values } = await processor(image)
    console.log('‚úÖ Image preprocessing completed')

    // Generate alpha matte
    console.log('🎯 Generating alpha matte...')
    const startTime = performance.now()
    const { output } = await model({ input: pixel_values })
    const inferenceTime = performance.now() - startTime
    console.log('‚úÖ Alpha matte generated', `Time: ${inferenceTime.toFixed(2)}ms`)

    // Save output mask
    console.log('üíæ Saving output...')
    const mask = await RawImage.fromTensor(output[0].mul(255).to('uint8')).resize(image.width, image.height)
    await mask.save('src/assets/mask.png')
    console.log('‚úÖ Output saved to assets/mask.png')

  } catch (error) {
    console.error('‚ùå Error during processing:', error)
    throw error
  }
}

main().catch(console.error)

Example Result

Input Image	Output Mask

📄 License

This project is licensed under the Apache - 2.0 license.

🔗 Links

• Repository: https://github.com/WuChenDi/MODNet
• Spaces: https://huggingface.co/spaces/wuchendi/MODNet
• SwanLab/MODNet: https://swanlab.cn/@wudi/MODNet/overview