텍스트 입력으로 이미지를 생성하고 편집하는 로컬 실행 도구
중간맛 분석
텍스트 프롬프트로 이미지를 생성하고 기존 이미지를 편집하는 Qwen-Image-2.1 모델을 Vulkan GPU에서 로컬 실행하는 크로스 플랫폼 애플리케이션입니다.
사용 흐름: 공개된 모델 파일을 준비한 뒤 명령어로 프롬프트를 입력하면 이미지가 생성됩니다. 같은 도구에서 이미지 편집, 최대 10개 참고 이미지 입력, 포즈·엣지 등 조건 이미지로 생성 제어(ControlNet), 스타일 어댑터(LoRA) 적용을 모두 지원합니다.
설치 및 실행: 공식 릴리스에서 바이너리를 받거나 CMake로 소스를 빌드할 수 있습니다. Vulkan 지원 GPU와 모델 파일(HuggingFace에서 공개)만 있으면 CUDA나 PyTorch 같은 추가 런타임 없이 즉시 실행 가능합니다. 메모리 요구사항은 해상도와 GPU 메모리에 따라 자동으로 조정됩니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 인터넷 연결 불안정 환경에서 클라우드 서비스 없이 로컬 이미지 생성 API를 운영해야 하는 개발팀
- 제한된 GPU 메모리(2GB VRAM) 환경의 엣지 장치에서 경량 이미지 편집 기능이 필요한 경우
- macOS·Linux·Windows에서 공통 바이너리 제공 없이 각 OS별로 이미지 생성 애플리케이션을 배포하려는 팀
핵심 기능
대안 대비 차별점
PyTorch나 CUDA 런타임 없이 Vulkan으로 구현하여 2GB VRAM에서도 작동하며, 모든 주요 OS와 GPU(NVIDIA·AMD·Intel·Apple)를 단일 구현으로 지원합니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Vulkan 지원 GPU (또는 CPU 모드 사용 가능, -g -1 옵션)
- 최소 16GB RAM (Windows는 RAM의 절반 + GPU 메모리 >= 16GB 필요)
- Qwen-Image-2.1 모델 파일 (HuggingFace에서 무료 다운로드)
- 소스 빌드 시 CMake 3.10 이상
바로 시작하기
- 레포지토리를 클론하고 서브모듈을 초기화합니다.
git clone https://github.com/nihui/qwenimage-ncnn-vulkan.git
cd qwenimage-ncnn-vulkan
git submodule update --init --recursive --depth 1
- 빌드 디렉토리를 생성하고 CMake를 구성합니다.
mkdir build
cd build
cmake ../src
- 프로젝트를 빌드합니다.
cmake --build . -j 4
-
모델 파일을 준비합니다. https://huggingface.co/nihui-szyl/qwen-image-ncnn 에서 qwenimage21 폴더를 다운로드하여 프로젝트 루트의 models/qwenimage21/ 디렉토리에 배치합니다.
-
이미지 생성을 테스트합니다.
./qwenimage-ncnn-vulkan -p "A small red kite over a quiet lake." -o output.png
대안: 바이너리를 사용하는 경우 (위의 1-3번 단계 대신) https://github.com/nihui/qwenimage-ncnn-vulkan/releases 에서 운영체제와 GPU 종류에 맞는 바이너리를 다운로드한 후, 4번과 5번 단계를 동일하게 수행합니다.
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try nihui/qwenimage-ncnn-vulkan
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
확인 시각
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2026년 생성
「AI 미디어 생성」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/nihui/qwenimage-ncnn-vulkan)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기