davidkrammer/imagegenkit

Imágenes con imagegenkit

imagegenkit se instala en ~/.local/bin/imagegenkit mediante la aplicación ImageGenKit o su instalador. Los proveedores, claves, valores predeterminados y qué proveedor maneja cada tarea son configuraciones del usuario en ImageGenKit. No hardcodees un proveedor a menos que el usuario nombre uno.

Elige la tarea

imagegenkit draft "PROMPT" -o out.jpg          # bocetos rápidos, ideas, borradores (más barato)
imagegenkit final "PROMPT" -o out.png          # diseños finales y maquetas de nivel final
imagegenkit edit "PROMPT" -i in.png -o out.png # editar o refinar una imagen (repite -i para combinar)
imagegenkit transparent "PROMPT" -o out.png    # PNG transparente: logo, sticker, recorte

Opciones comunes: --aspect 16:9, -n 2, -i ref.png, -f prompt.txt, --dry-run. Ejecuta imagegenkit <tarea> -h para más información. Solo si el usuario pide un proveedor específico: imagegenkit openai|grok|codex|xai|gemini|<otro> "PROMPT" o imagegenkit draft -p openai ....

Reglas

• Inicio de una sesión: ejecuta imagegenkit providers una vez. Si nada está listo, pide al usuario que abra ImageGenKit › Configuración › Proveedores. Nunca pidas claves API en el chat, nunca las imprimas, nunca las escribas en archivos.
• Menor costo que se ajuste. Ideas y borradores usan draft. Usa final solo para trabajos terminados. Usa -n 1 y pregunta antes de hacer más de aproximadamente 6 imágenes de pago a la vez.
• Convertir un borrador en final: pasa el borrador con -i a edit o final.
• Texto exacto, números o texto de UI: si debe ser exacto (gráficos, diagramas, UI real), constrúyelo en HTML/SVG en su lugar.
• Mira antes de reportar: abre la imagen y verifica ortografía, manos y rostros, logotipos, recorte y relación de aspecto. Corrígelo con edit si es necesario. Reporta la ruta guardada y llámalo borrador generado.
• Activos del proyecto: escribe directamente en la carpeta de activos del proyecto con un nombre sensato. No sobrescribas archivos existentes a menos que se te pida. Las salidas existentes nunca se sobrescriben; imagegenkit añade -2, -3 y así sucesivamente.
• Prompts: 2–5 oraciones de prosa simple que cubran sujeto, entorno, estilo, composición e iluminación. Pon el texto requerido entre comillas. Para ediciones, di qué debe permanecer sin cambios.
• Errores: lee el mensaje del proveedor y ajusta; no reintentes ciegamente. Un bloqueo por moderación significa detente e informa al usuario.
• Límites mensuales: el usuario puede establecer un límite de gasto o de imágenes en ImageGenKit. Si imagegenkit dice que se alcanzó un límite, informa al usuario y no lo evites (sin -p a otro proveedor, sin llamadas API directas). Las suscripciones (Grok, Codex) siguen funcionando; los comandos de tarea cambian a ellas automáticamente. imagegenkit usage muestra el gasto y los límites de este mes.

Salida

Las rutas guardadas van a stdout, una por línea. Sin -o, los archivos van a ~/Pictures/ImageGenKit/<fecha>/. Cada ejecución se registra en ~/.config/imagegenkit/log.jsonl, y el usuario ve el uso, costos y todo lo generado en ImageGenKit. Reutiliza un prompt del registro cuando el usuario diga "como la última vez".