metadata

title: ImageAlfred
emoji: 😻
colorFrom: green
colorTo: purple
sdk: gradio
sdk_version: 5.32.1
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

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

Maintainers

Mahan Yarmohammad (Mahan-ym) Saaed Saadatipour (Soodoo)

Used Tools

Gradio: Serving user interface and MCP server
lang-segment-anything: Which uses SAM and Grounding Dino under the hood to segment images.
HuggingFace: Downloading SAM and using Space for hosting.
Modal.com: AI infrastructure making all the magic possible.

Getting Started

Prerequisites

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

Installation

Create a virtual environment using uv:

uv venv

Activate the virtual environment:

source .venv/bin/activate

Install dependencies:

uv sync

Setup Modal

modal setup

Running the App

uv run src/app.py

This will launch the Gradio interface for ImageAlfred.

License

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