sinmb79/22b-studio

22B Studio

시나리오 하나로 지브리 스타일 애니메이션을 만드는 n8n 파이프라인 An n8n pipeline that turns a single scenario into Ghibli-style animation

소개 | Introduction

22B Studio는 별도 프로그램이 아닌 운영형 템플릿 레포입니다. n8n이 전체 제작 흐름을 관리하고, ComfyUI가 이미지를 만들고, FFmpeg/Real-ESRGAN이 후반 작업을 맡습니다. 시나리오를 넣으면 무드보드부터 최종 영상까지 7단계 파이프라인으로 진행됩니다.

22B Studio is not a standalone app -- it is an operations-ready template repo. n8n orchestrates the full pipeline, ComfyUI generates visuals, and FFmpeg/Real-ESRGAN handle finishing. Feed in a scenario, and it flows through a 7-stage pipeline from mood board to final video.

이런 분들에게 유용합니다 | Who Is This For?

7단계 제작 파이프라인 | 7-Stage Production Pipeline

시나리오를 넣으면 아래 순서로 진행됩니다. 매 단계에서 사람이 검수합니다.

Feed in a scenario and it flows through these stages. Human review at every checkpoint.

시나리오 입력
    |
    v
1. 무드보드 (Mood Board)        -- 분위기/컨셉 이미지 생성
    |
    v
2. 캐릭터 시트 (Character Sheet) -- 캐릭터 일관성 확보
    |
    v
3. 배경 컨셉 (Background)       -- 배경 이미지 생성
    |
    v
4. 스케치 콘티 (Sketch)          -- 저비용으로 구도 확정
    |     [사람 검수: 구도 OK?]
    v
5. 풀 렌더 (Full Render)         -- 확정된 장면만 고품질 렌더링
    |
    v
6. 영상 클립 (Video Clips)       -- AnimateDiff로 모션 추가
    |
    v
7. 업스케일 + 마감 (Finishing)    -- Real-ESRGAN 업스케일, FFmpeg 편집

핵심 원칙: 스케치에서 싸게 실패하고, 풀 렌더는 필요한 장면만.

Key principle: Fail cheaply at sketch stage, spend full-render cost only where it matters.

레포에 들어있는 것 | What's Included

n8n 워크플로우 | n8n Workflows

ComfyUI 워크플로우 | ComfyUI Workflows

프롬프트 템플릿 | Prompt Templates

장면 유형별(실내/실외/클로즈업/와이드/액션) 프롬프트를 제공합니다:

프롬프트 변수 예시 | Prompt Variable Example:

{
  "positive": "Studio Ghibli anime style, {scene_description}, {scene_archetype}, {philosophy_note}, emotional concept art, {emotional_hint}, key prop {key_prop}, watercolor textures, cinematic composition, {character_description}",
  "negative": "3d, realistic, photograph, horror, nsfw, low quality, blurry, text, watermark, deformed",
  "params": {
    "steps": 20,
    "cfg": 6.0,
    "resolution": "1024x1536",
    "sampler": "dpm++_2m_karras"
  }
}

필요한 환경 | Requirements

빠른 시작 가이드 | Quick Start Guide

1단계: 모델 준비 | Step 1: Prepare Models

ComfyUI/models/
|-- checkpoints/     <- SDXL 또는 animagineXL 모델
|-- loras/           <- ghibli-style.safetensors
|-- ipadapter/       <- IP-Adapter SDXL (선택)
|-- controlnet/      <- ControlNet Canny SDXL (선택)
+-- upscale_models/  <- Real-ESRGAN x4plus-anime

자세한 모델 목록은 comfyui-workflows/MODELS.md를 참고하세요.

2단계: n8n/ComfyUI 실행 | Step 2: Start Services

# n8n 실행
n8n start
# 또는 Docker: docker run -p 5678:5678 n8nio/n8n

# ComfyUI 실행
python main.py --listen 0.0.0.0 --port 8188

3단계: 워크플로우 가져오기 | Step 3: Import Workflows

1. n8n 웹 UI에서 Import from File 선택
2. n8n-workflows/22b-studio-ghibli.json 가져오기
3. ComfyUI에서 comfyui-workflows/ 내 JSON 파일들을 로드
4. n8n 워크플로우에서 ComfyUI API 주소 확인 (http://localhost:8188)

4단계: 시나리오 입력 후 실행 | Step 4: Run with a Scenario

n8n 워크플로우를 실행하고 시나리오를 입력하면, 무드보드부터 영상까지 자동으로 진행됩니다. 각 단계에서 검수 후 다음으로 넘어갑니다.

프로젝트 구조 | Project Structure

22b-studio/
|-- n8n-workflows/           # n8n 워크플로우 JSON (5개)
|-- comfyui-workflows/       # ComfyUI 워크플로우 JSON (6개)
|   +-- MODELS.md            # 필요한 모델 목록
|-- prompts/ghibli/          # 지브리 프롬프트 템플릿 (7개)
|-- quality/
|   |-- gold-standard/       # 기준 이미지 (품질 비교용)
|   +-- test-results/        # 테스트 결과 기록
|-- docs/                    # 설치/운영 문서
|   |-- getting-started-ko.md
|   |-- getting-started-en.md
|   |-- ghibli-pipeline.md
|   +-- n8n-setup.md
+-- SOURCE-MAP.md            # 외부 자산 재사용 기준

외부 자산 연동 | External Asset Integration

22B Studio는 기존 도구를 재사용합니다. 새 프로그램을 만들지 않습니다.

22B Studio reuses existing tools. No new applications are built.

검수 원칙 | Quality Principles

• 모든 주요 단계는 사람 검수를 거칩니다
• 스케치에서 구도를 먼저 확정합니다
• 풀 렌더와 영상은 개별 장면 단위로 재시도합니다
• 품질이 부족하면 프롬프트만 추출해 수동 보완합니다

상세 문서 | Documentation

• 한국어 시작 가이드
• English Getting Started
• 지브리 파이프라인 상세
• n8n 설정 가이드
• 외부 자산 재사용 기준
• 필요한 모델 목록

라이선스 | License

MIT License -- 자유롭게 사용, 수정, 배포할 수 있습니다.

MIT License -- Free to use, modify, and distribute.

만든 사람 | Author

22B Labs (sinmb79) -- The 4th Path

문의사항이나 기여는 Issues를 이용해 주세요.

For questions or contributions, please use Issues.