AgriciDaniel/banana-claude

Banana Claude – Gemini를 위한 AI 가이드 이미지 생성

기능 설명
Banana Claude는 이미지에 대한 자연어 설명을 완전히 계획된 Gemini(Google AI) 이미지 생성 요청으로 변환하는 명령줄/플러그인 도구입니다. 먼저 비주얼 브리프(프롬프트, 모델 선택, 데이터 설정, 비용 추정)를 작성하여 유료 호출 전에 검토할 수 있습니다. 계획을 승인하면 요청을 실행하고, 이미지를 개인정보 보호 중심의 메타데이터 사이드카와 함께 저장하며, 최대 3개의 변형을 검사, 편집, 반복 또는 비교할 수 있습니다.

주요 기능

• 계획 우선 워크플로우 – 상세 요청(프롬프트, 모델, 가격)을 오프라인으로 생성하며, 명시적 승인이 필요합니다.
• 모델 라우팅 – Google의 Nano Banana 2.1(기본값), Nano Banana 2 Lite, Nano Banana Pro 및 512픽셀 초안용으로 더 이상 사용되지 않는 2 라우트를 지원합니다.
• 편집 및 계속 – 정체성, 지오메트리, 브랜드 세부 정보를 유지하면서 단일 변경을 수행하거나 저장된 Nano Banana 2.1/Pro 데이터로 세션을 계속합니다.
• 비교 – 단일 제한된 포트폴리오에서 3개의 모델 라우트에 걸쳐 최대 3개의 프롬프트를 실행합니다.
• 조판 – 정확한 텍스트가 필요한 경우 로컬에서 카피, 글꼴, 로고, 신뢰할 수 있는 래스터 아트를 추가합니다.
• 안전 및 비용 제어 – API 키가 명령이나 CI에 표시되지 않으며, 각 유료 호출은 계획을 표시하고 일회성 승인이 필요하며, 비용 로그는 비공개이고, 원시 프롬프트는 기본적으로 생략됩니다.

시작 방법

1. README에 표시된 마켓플레이스 명령을 통해 플러그인을 설치합니다.
2. Gemini API 키(결제가 활성화된 Google AI 프로젝트)를 제공하고 Linux/macOS를 사용 중인지 확인합니다(Windows는 WSL 필요).
3. 다음과 같은 명령을 실행합니다:

   /banana-claude:banana generate an urban 16:9 GitHub hero with clean left‑side copy space
   

4. 생성된 계획(프롬프트, 모델, 추정)을 검토하고 승인합니다.
5. 이미지가 생성되어 로컬에 저장되며, 확인, 편집 또는 배포할 수 있습니다.

대상 사용자
수동으로 프롬프트를 작성하거나 예상치 못한 비용의 위험을 감수하지 않고 Google의 Gemini 이미지 모델을 통제되고 감사 가능한 방식으로 사용하려는 디자이너, 마케터 또는 개발자. 검토와 승인을 강조하므로 비용, 개인정보 보호 및 출처가 중요한 프로덕션급 워크플로우에 적합합니다.

제한 사항

• Linux/macOS에서만 작동합니다. Windows 지원은 보류 중입니다(WSL 필요).
• 유료 Gemini 이미지 생성에 의존합니다 – 무료 티어가 없습니다.
• 확률적 출력만 보장합니다. 철자, 지오메트리 또는 정책 준수는 보장되지 않습니다.

더 알아보기

• 사용자 가이드, 프롬프트 작성 팁 및 보안 세부 정보는 docs/ 폴더에 있습니다.
• 리포지토리에는 CI 검증 워크플로우와 버전 관리된 릴리스 노트가 포함되어 있습니다.

라이선스 – MIT.

---

위의 모든 정보는 리포지토리의 README에서 직접 가져온 것입니다.