사진 한 장으로 macOS/Windows 폴더 아이콘을 자동 생성·적용하는 에이전트. Gemini 2.5 Flash Image(또는 OpenAI gpt-image-1)로 사진 속 캐릭터/얼굴 특징을 살린 3D 클레이 폴더 아이콘 4장 후보를 만들고, 투명 배경 자동 처리 후 사용자가 고른 것을 대상 폴더에 적용한다. 클립보드/최근 다운로드에서 사진 자동 탐지 지원. 4장 후보는 HTML 미리보기 페이지로 한 번에 비교.
anpm install folder-decorateType /folder-decorate in the chat.
Auto-applied rules are also installed.
| Commands | README |
|---|---|
| /folder-decorate | 사진을 입력받아 폴더 아이콘 4장 후보를 만들고 사용자가 고른 걸로 폴더에 적용 |
| /setup-folder-decorate | folder-decorate 의존성 자동 설치 + API 키 가이드 |
CLI Tools
python3fileiconEnvironment Variables
GEMINI_API_KEYGoogle AI Studio API 키 (https://aistudio.google.com/app/apikey 에서 무료 발급). Gemini 2.5 Flash Image 호출에 사용.
1. https://aistudio.google.com/app/apikey 접속
OPENAI_API_KEYOpenAI API 키 (gpt-image-1 호출용). PROVIDER=openai 일 때만 필요.
PROVIDER이미지 생성 프로바이더 선택. gemini | openai (기본: gemini)
GEMINI_IMAGE_MODELGemini 모델 오버라이드 (기본: gemini-2.5-flash-image). 더 새로운 모델로 바꿀 때 사용.
RELAY_PROXY_URL(옵션) 프록시 서버 URL. 설정 시 직접 API 호출 대신 프록시 경유.
Runtime
anpm install folder-decorate