isixe/bg2x

어떤 프로젝트인가요?

핵심 기능

• 01Real-ESRGAN, Swin2SR, Real-CUGAN 모델로 이미지를 최대 4배까지 업스케일합니다.
• 02이미지를 업로드하지 않고 브라우저에서 전부 클라이언트 측으로 실행됩니다.
• 03사진, 애니메이션, 일러스트, 압축 이미지용 모델 10개를 제공합니다.
• 04WebGPU를 사용할 수 있으면 활용하고, 그렇지 않으면 WASM으로 대체합니다.
• 05PNG, JPG, WebP로 내보내고 여러 결과물을 ZIP으로 다운로드할 수 있습니다.
• 06처음 다운로드한 뒤 모델을 IndexedDB에 캐시합니다.
• 07Windows, macOS, Linux용 Electron 데스크톱 빌드를 제공합니다.

활용 사례

• 오래되었거나 해상도가 낮은 애니메이션 및 일러스트 작품을 업스케일할 때.
• 이미지를 서버로 전송하지 않고 압축되었거나 노이즈가 많은 사진을 확대할 때.
• 이미지 폴더를 일괄 확대하고 ZIP으로 내보낼 때.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/isixe/bg2x.git
2. 2

   프로젝트 폴더로 이동합니다

   cd bg2x
3. 3

   종속성을 설치합니다

   pnpm install
4. 4

   개발 서버를 시작한 다음 http://localhost:4321 을 엽니다

   pnpm dev

사용 전 알아둘 점

• !설치에는 pnpm을 사용합니다. 저장소에 package-lock.json과 pnpm-lock.yaml이 모두 있으므로 패키지 관리자를 혼용하지 마세요.
• !스레드형 WASM 추론을 사용하려면 프로덕션 호스트에 교차 출처 격리 헤더가 필요합니다. 헤더가 없으면 단일 스레드로 대체됩니다.
• !모델은 처음 사용할 때 Hugging Face에서 다운로드되며(ModelScope로 대체 가능), 최초 사용 시 네트워크 연결이 필요합니다.

토픽

자주 묻는 질문

bg2x은(는) 무엇인가요?

이미지를 기기 밖으로 전송하지 않고 로컬에서 실행되는 무료 브라우저 기반 AI 이미지 업스케일러입니다. bg2x는 Real-ESRGAN, Swin2SR, Real-CUGAN 모델을 사용해 이미지를 최대 4배까지 업스케일합니다. 추론은 Web Worker 안에서 ONNX Runtime Web을 통해 브라우저에서 전부 실행되므로 백엔드가 필요 없고 이미지를 업로드할 필요도 없습니다.

bg2x은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

bg2x은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

bg2x은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. bg2x의 마지막 커밋은 2026년 10월 10일입니다.

bg2x은(는) 어디에 사용할 수 있나요?

오래되었거나 해상도가 낮은 애니메이션 및 일러스트 작품을 업스케일할 때. 이미지를 서버로 전송하지 않고 압축되었거나 노이즈가 많은 사진을 확대할 때. 이미지 폴더를 일괄 확대하고 ZIP으로 내보낼 때.

bg2x는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/isixe/bg2x.git 프로젝트 폴더로 이동합니다: cd bg2x 종속성을 설치합니다: pnpm install 개발 서버를 시작한 다음 http://localhost:4321 을 엽니다: pnpm dev

bg2x은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/isixe/bg2x