ImageAlfred / README.md
mahan_ym
Add .mp4 file support to .gitattributes and include demo video
47fd4b6

A newer version of the Gradio SDK is available: 5.34.2

Upgrade
metadata
title: ImageAlfred
emoji: 😻
tags:
  - mcp-server-track
colorFrom: green
colorTo: purple
sdk: gradio
sdk_version: 5.33.0
app_file: src/app.py
pinned: false
license: apache-2.0
short_description: 'Alfred of Images: An MCP server to handle your image edits.'
ImageAlfred

Image Alfred

ImageAlfred is an image Model Context Protocol (MCP) tool designed to streamline image processing workflows

Python Version from PEP 621 TOML GitHub License

huggingface python

Demo

🎬 Video demo

Maintainers

Mahan-ym | Mahan Yarmohammad

Soodoo | Saaed Saadatipour

Tools

  • Gradio: Serving user interface and MCP server.
  • Modal.com: AI infrastructure making all the magic 🔮 possible.
  • SAM: Segment Anything model by meta for image segmentation and mask generation.
  • CLIPSeg: Image Segmentation using CLIP. We used it as a more precise object detection model.
  • OWLv2: Zero-Shot object detection (Better performance in license plate detection and privacy preserving use-cases)
  • HuggingFace: Downloading SAM and using Space for hosting.

Getting Started

Prerequisites

  • Python 3.12+
  • uv (a fast Python package installer and virtual environment manager)

Installation

It will create virtual environment, activate it, install dependecies and setup modal

make install

Running the App

This will launch the Gradio interface for ImageAlfred.

make run

License

This project is licensed under the terms of the LICENSE file in this repository.