Practical overview
When it fits
Use it when you want to build an image-editing workflow around a model and code, especially for prompt-led edits, portraits or multi-image composition.
Who it is for
- Developers seeking a self-hosted image-editing model and inference code.
- Creators working on instruction-guided portrait edits, image compositions or text-reference styling.
Documented uses
- Apply a requested change to an input image using a written prompt.
- Combine elements from multiple images into a composition.
- Create portrait retouching or makeup edits and preserve subject identity across edits.
Requirements & limits
The repository lists an Apache-2.0 license and links to model and demo pages on Hugging Face and ModelScope.
- The primary documented path is repository-based Python inference, rather than a hosted editing application.
- The model natively supports one to three input images; the Agent module is described for preprocessing larger image sets.
- Recaptioning requires configuring an LLM provider, while the README says basic Agent region detection and stitching do not require an LLM API.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Run the documented single-image inference example
Install the listed dependencies and invoke the repository's image-editing example.
Before you start
- Python environment
- Repository files, including requirements.txt and inference.py
- An input image
Steps
Install dependencies with pip install -r requirements.txt.
Run inference.py with an input image, an editing prompt, an output-image path and a seed, following the README example.
Expected outcome
The example is configured to write an edited image to the specified output path.
Guide limitations
- The example prompt is in Chinese.
Compare options for Model inference and serving
These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.
| Project | Documented purpose | Platform | Access and requirements |
|---|---|---|---|
| Firered Image Edit | Apply a requested change to an input image using a written prompt. | Linux, Self-hosted | The repository lists an Apache-2.0 license and links to model and demo pages on Hugging Face and ModelScope. |
| Controlvideo | Generate video from a text prompt with structural guidance. | Linux | The implementation is available as a public GitHub repository under the MIT license. The README separately links to Hugging Face and Replicate demos. |
| Catvton | Generate images showing a garment on a person. | Cloud, Self-hosted | The repository documents a local Python setup and a Hugging Face demo. It states that the code, checkpoints and demo are licensed under Creative Commons BY-NC-SA 4.0 for non-commercial reuse with attribution and share-alike terms. |
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 3 November 2026
- Original website title
- FireRedTeam/FireRed-Image-Edit · Official homepage title · retained in its source language

