explaingit

meigen-ai/genevolve

Analysis updated 2026-05-18

29PythonAudience · researcherComplexity · 5/5Setup · hard

TLDR

A research AI agent that gathers text and image references for a prompt, then outputs a structured plan that any compatible image generator can use to create the image.

Mindmap

mindmap
  root((GenEvolve))
    What it does
      Gather references
      Build generation plan
      Stay transferable
    Tech stack
      Python
      PyTorch
      vLLM
      Qwen3-VL
    Use cases
      Image agent research
      Cross-generator plans
      Benchmark study
    Audience
      Researchers
      ML engineers
    Setup
      CUDA GPU
      API keys
      vLLM serving

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate an image plan from an open-ended prompt using web and image search tools.

USE CASE 2

Send the same agent output to different image generation backends without retraining.

USE CASE 3

Study the released training trajectories and evaluation benchmark for agent research.

USE CASE 4

Serve the agent policy efficiently at scale using vLLM.

What is it built with?

PythonPyTorchvLLMQwen3-VL-8BCUDA

How does it compare?

meigen-ai/genevolveadityasharmadotai-hash/docs-reader-rag-agentalekseiul/hermes-researcher-agent
Stars292929
LanguagePythonPythonPython
Setup difficultyhardeasymoderate
Complexity5/52/52/5
Audienceresearchervibe coderresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires a CUDA GPU, specific PyTorch and vLLM versions, and external API keys for search tools.

The README does not state a license.

In plain English

GenEvolve is a research project from teams at Hong Kong University of Science and Technology and Meituan, published as an academic paper. The goal is to build an AI agent that can generate images in response to open-ended prompts, not by generating pixels directly, but by first gathering information and then producing a structured program that tells a separate image generation model what to create and what reference images to use. The agent works by calling a set of tools: a web search tool to find textual information about the requested subject, an image search tool to find visual references, and a knowledge query tool to access generation skills the agent has learned. After gathering that material, the agent produces a combined output of a text prompt and a set of reference images, which gets passed to a backend image generator. The key claim of the research is that this output is generator-transferable: the same agent output can be sent to the open Qwen-Image-Edit model or to a stronger proprietary image generator, without the agent needing to be retrained for each one. The released agent policy is built on Qwen3-VL-8B, a vision-language model, and is served via vLLM for efficient inference. The repository includes the trained agent weights on HuggingFace, the three tools, eight skill description files used during training, wrappers for both supported image generation backends, and around 9,000 training trajectories plus a 594-prompt evaluation benchmark. Setting up the project requires a CUDA-capable GPU, Python 3.11, and a specific set of library versions including PyTorch 2.8, vLLM 0.11, and Flash Attention. The image generation service runs as a separate process from the agent, and external API keys for Serper (web search) and optionally Google's Generative Language API are needed to use the full tool set. This is a research codebase accompanying an arXiv paper, not a consumer product. The README is detailed and assumes familiarity with GPU model serving and machine learning infrastructure.

Copy-paste prompts

Prompt 1
Help me set up GenEvolve with vLLM and a CUDA GPU on my machine.
Prompt 2
Explain how GenEvolve's agent output stays transferable across different image generators.
Prompt 3
Walk me through the three tools GenEvolve's agent uses to gather references.
Prompt 4
Show me how to run the released evaluation benchmark against the agent.

Frequently asked questions

What is genevolve?

A research AI agent that gathers text and image references for a prompt, then outputs a structured plan that any compatible image generator can use to create the image.

What language is genevolve written in?

Mainly Python. The stack also includes Python, PyTorch, vLLM.

What license does genevolve use?

The README does not state a license.

How hard is genevolve to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is genevolve for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.