{
  "hf_id": "meituan-longcat/LongCat-Image-Edit",
  "meta": {
    "title": "LongCat-Image-Edit",
    "slug": "longcat-image-edit",
    "provider": "LongCat (Meituan)",
    "description": "Bilingual (Chinese-English) image editing model from Meituan LongCat, served via vLLM-Omni",
    "date_added": "2025-12-23",
    "date_updated": "2026-04-17",
    "tasks": [
      "omni"
    ],
    "related_recipes": []
  },
  "model": {
    "model_id": "meituan-longcat/LongCat-Image-Edit",
    "min_vllm_version": "0.12.0",
    "architecture": "dense",
    "parameter_count": "6B",
    "active_parameters": "6B",
    "context_length": 0,
    "base_args": [],
    "base_env": {},
    "install": {
      "pip": {
        "command": "uv venv\nsource .venv/bin/activate\nuv pip install -U vllm --torch-backend auto"
      },
      "docker": {
        "command": "docker pull vllm/vllm-openai:latest"
      },
      "extras": [
        {
          "note": "vLLM-Omni must be installed from source with vllm==0.12.0 for LongCat-Image-Edit",
          "command": "git clone https://github.com/vllm-project/vllm-omni.git && cd vllm-omni && uv pip install -e . vllm==0.12.0"
        },
        {
          "note": "xformers CUDA 12.8 build required for the diffusion attention kernels",
          "command": "uv pip install -U xformers --index-url https://download.pytorch.org/whl/cu128"
        },
        {
          "note": "diffusers from source (needed by the image-edit pipeline)",
          "command": "git clone https://github.com/huggingface/diffusers.git && cd diffusers && uv pip install -e ."
        }
      ]
    }
  },
  "omni": {
    "tasks": [
      "i2i"
    ]
  },
  "features": {},
  "opt_in_features": [],
  "variants": {
    "default": {
      "precision": "bf16",
      "vram_minimum_gb": 36,
      "description": "BF16 weights; served via vLLM-Omni"
    }
  },
  "hardware_overrides": {},
  "guide": "## Overview\n\nLongCat-Image-Edit is the image-editing variant of LongCat-Image by Meituan. It supports\nbilingual (Chinese-English) editing instructions and is served via **vLLM-Omni** (not\nstandard vLLM). It achieves SOTA performance among open-source image editing models.\n\n## Prerequisites\n\n- Hardware: 1x GPU with >=40 GB VRAM\n- vLLM-Omni (runs on top of vLLM 0.12.0)\n- diffusers (latest from source)\n- xformers (latest)\n\n## Installation\n\n```bash\n# Clone and install vllm-omni\ngit clone https://github.com/vllm-project/vllm-omni.git\ncd vllm-omni\nuv venv\nsource .venv/bin/activate\nuv pip install -e . vllm==0.12.0\n\n# Update xformers to the latest version\nuv pip install -U xformers --index-url https://download.pytorch.org/whl/cu128\n\n# Update diffusers to the latest version\ngit clone https://github.com/huggingface/diffusers.git\ncd diffusers\nuv pip install -e .\n```\n\n## Usage\n\n```bash\ncd vllm-omni\npython3 ./examples/offline_inference/image_to_image/image_edit.py \\\n    --image qwen_bear.png \\\n    --prompt \"Add a white art board written with colorful text 'vLLM-Omni' on grassland. Add a paintbrush in the bear's hands. Position the bear standing in front of the art board as if painting.\" \\\n    --output output_image_edit.png \\\n    --num_inference_steps 50 \\\n    --guidance_scale 4.5 \\\n    --seed 42 \\\n    --model meituan-longcat/LongCat-Image-Edit \\\n    --cache_backend cache_dit \\\n    --cache_dit_max_continuous_cached_steps 2\n```\n\n## References\n\n- [LongCat-Image-Edit on Hugging Face](https://huggingface.co/meituan-longcat/LongCat-Image-Edit)\n- [vLLM-Omni](https://github.com/vllm-project/vllm-omni)\n",
  "source": {
    "source": "vllm-omni",
    "repo": "vllm-project/vllm-omni",
    "ref": "main",
    "sha": "cda4a1ef83b295ba332146a7709e6277725edc9f",
    "path": "recipes/models/meituan-longcat/LongCat-Image-Edit.yaml",
    "edit_url": "https://github.com/vllm-project/vllm-omni/edit/main/recipes/models/meituan-longcat/LongCat-Image-Edit.yaml",
    "overlays": []
  }
}