IconFlow

Getting Started · instalación desde el código fuente

Da a tu agente
el brief.
Conserva la prueba.

IconFlow convierte la intención del producto en un SVG editable y somete el diseño a píxeles nativos, recortes de plataforma y una revisión ligada a la fuente antes de publicar cualquier activo.

Ejecuta la prueba de cinco minutos Copia el brief del agente
  • Python 3.10+
  • Git
  • Acceso a red para la configuración inicial
TRASPASO AL AGENTE01 / 04
INTENCIÓN DEL PRODUCTO

Ayudar a comparar investigaciones sin perder el hilo.

esencia · pruebaevitar · destellos
La decisión se puede inspeccionarbrief · SVG · revisión · receipt (comprobante) · caso

El modelo operativo

El agente diseña.
IconFlow lo prueba.

El agente investiga el producto, explora conceptos distintos y crea SVG semántico. IconFlow aporta el manual de diseño, el renderizador determinista, el control de calidad, las transformaciones de destino y el ciclo de aprendizaje. No es un generador de imágenes a partir de prompts.

Elige tu vía

Dos puertas.
Un solo control de calidad.

Usa la vía del agente si quieres ayuda para pensar el producto y crear el SVG. Usa la vía de la CLI si ya controlas las decisiones de diseño. Ambas terminan en el mismo contrato de revisión.

RecomendadoAsistido por agente

Describe la función del producto, no la imagen.

Instala la skill de IconFlow, de formato abierto. Un agente compatible puede descubrir el flujo de trabajo cuando pides un icono de app, un favicon, una marca o un icono de bandeja del sistema.

  1. 01Instala la skill una vez
  2. 02Da al agente contexto del producto
  3. 03Inspecciona su comparativa y Review Lab
Usa el brief del agente
TransparenteCLI directa

Toma todas las decisiones.

Lee el manual de diseño, crea los SVG finalistas y usa los mismos comandos que ejecuta el agente. No hay ningún servicio oculto tras la CLI.

  1. 01Crea iconflow.toml
  2. 02Compara y revisa los candidatos
  3. 03Publica solo con una aprobación vigente
Consulta todos los comandos

¿Usas otro agente de IA? Cualquier agente capaz de leer las instrucciones del repositorio y ejecutar comandos de shell puede usar IconFlow mediante AGENTS.md y la CLI. La detección automática de skills depende del cliente.

Prueba del motor en cinco minutos

Comprueba el pipeline
antes de diseñar.

Esto compila la familia revisada y versionada de IconFlow en un directorio de trabajo desechable. Demuestra que tu entorno funciona —no que una identidad nueva y distintiva pueda diseñarse en cinco minutos.

01ClonaObtén el código fuente actual.
02ConfiguraInstala las dependencias de Python, Chromium y la skill del agente.
03Publica la pruebaVuelve a validar el receipt y genera 23 activos.

Windows · PowerShell

git clone https://github.com/snowyukitty/ai-iconflow.git
cd ai-iconflow
python -m venv .venv
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup.ps1
.\.venv\Scripts\python.exe -m iconflow doctor
.\.venv\Scripts\python.exe -m iconflow ship `
  --config brand\iconflow.toml `
  --review brand\master-review.json `
  --out work\quick-start\icon-out

macOS / Linux · shell

git clone https://github.com/snowyukitty/ai-iconflow.git
cd ai-iconflow
python3 -m venv .venv
sh ./scripts/setup.sh
./.venv/bin/python -m iconflow doctor
./.venv/bin/python -m iconflow ship \
  --config brand/iconflow.toml \
  --review brand/master-review.json \
  --out work/quick-start/icon-out
Marca de IconFlow
Resultado esperado

Un control, no solo una carpeta.

doctorinforma de que el renderizador está listo. ship verifica la fuente versionada y el contrato de revisión, repite el control de calidad y genera activos web, PWA, de escritorio Tauri, Electron y de bandeja del sistema en work/quick-start/icon-out/.

  • coincide el hash de la fuente
  • 0 advertencias automáticas
  • seis puntuaciones ≥ 4/5

Empieza por la intención

Da al agente
un brief útil.

Un prompt con solo un sustantivo genera decoración. Incluye la función del producto, el público, la personalidad, la paleta, los clichés que evitar y las superficies de salida exactas.

BRIEF / 01Lo que necesita el agente
Intención del producto
¿Qué hace posible el producto?
Tarea del usuario
¿Qué avance busca el usuario?
Esencia
Una palabra que guíe cada decisión.
Personalidad
Dos o tres rasgos en tensión.
Clichés
Los símbolos obvios de la categoría que debes descartar.
Destinos
Web, PWA, escritorio, bandeja del sistema —o solo lo que exista.

Prompt para el agente

Use the IconFlow skill to design, review, and ship a distinctive icon family for this project.

Product intent: [what the product enables]
User job: [the progress a person wants]
Essence: [one word]
Personality: [two or three traits]
Existing palette: [tokens or colors]
Clichés to avoid: [obvious symbols]
Targets: [web, pwa, tauri, electron, tray]

Keep the editable SVG and iconflow.toml in this project. Show me the concept bake-off and native-size review before shipping. Do not stop before recording the case.

Alternativa universal

¿Sin detección de skills? Dale al agente el contrato.

Funciona con cualquier agente capaz de leer archivos y ejecutar la CLI local de Python, aunque su cliente no admita Agent Skills.

Read [ICONFLOW_REPO]/AGENTS.md completely.
Use [ICONFLOW_REPO]/.venv/.../python -m iconflow ...
Keep your shell in this consuming project.
Follow concept → compare → check → review → ship → case.

El ciclo completo

Cada comando
se gana su lugar.

Ejecuta estos comandos desde el proyecto que usa IconFlow. Usa Python del entorno virtual de IconFlow mediante su ruta absoluta para que la configuración y las fuentes finales permanezcan con el producto al que pertenecen.

  1. 01
    Brief

    Escribe el contrato del producto.

    Registra la intención antes de dibujar. La configuración también fija destinos, colores, rutas y el comportamiento de la bandeja del sistema.

    python -m iconflow init --out iconflow.toml \
  --name "My App" --essence proof \
  --targets web,tauri,electron,tray
  2. 02
    Explora

    Fuerza ideas visuales distintas.

    Crea al menos cuatro conceptos desde perspectivas distintas. Los preajustes de técnica sirven de andamiaje; nunca son identidades terminadas.

    python -m iconflow styles
python -m iconflow new flat-geometric \
  --out work/my-app/a.svg
  3. 03
    Compara

    Elige la forma antes de pulir.

    Renderiza juntos dos o tres finalistas. Evalúa la lámina a 128px, 16px y en silueta.

    python -m iconflow compare \
  work/my-app/a.svg work/my-app/b.svg \
  work/my-app/c.svg --out work/my-app/bake.png
  4. 04
    Inspecciona

    Revisa transformaciones reales de cada destino.

    Corrige todas las advertencias. Después inspecciona los píxeles nativos, el alfa, los recortes adaptativos, las esquinas de escritorio y los contextos de bandeja del sistema.

    python -m iconflow check master.svg
python -m iconflow review --config iconflow.toml \
  --out work/my-app/review.png \
  --html work/my-app/review.html
  5. 05
    Publica

    Haz que cualquier fallo bloquee la aprobación.

    Exporta el receipt de Review Lab solo cuando cada eje alcance 4/5. Los cambios en la fuente o los destinos dejan obsoleto ese receipt.

    python -m iconflow ship \
  --config iconflow.toml \
  --review master-review.json
  6. 06
    Aprende

    Devuelve lo aprendido al sistema.

    Registra qué falló primero, qué cambió y una regla reutilizable. Un icono sin registro no enseña nada.

    python -m iconflow case new ...
python -m iconflow case lint
python -m iconflow case stats

Familias de salida exactas

Pide solo
las superficies que publicas.

Los destinos son explícitos. IconFlow no promete «todas las plataformas», y una tarjeta de app completa no se convierte sin más en una silueta útil para la barra de menús.

WEB / PWA

Superficies del navegador

favicon en SVG e ICO, Apple touch icon, activos PWA de 192px y 512px, además de un icono enmascarable y un fragmento de manifiesto.

--targets web,pwa
TAURI

Paquete de escritorio

Tamaños PNG, ICO, ICNS y la estructura convencional src-tauri/icons para aplicaciones de escritorio Tauri v2.

--targets tauri
ELECTRON

Entradas para el empaquetador

Activos PNG, ICO e ICNS multiplataforma para los flujos de empaquetado de Electron y electron-builder.

--targets electron
BANDEJA DEL SISTEMA

Marcas para la barra de menús

PNG en color para la bandeja del sistema, activos de plantilla de macOS y una utilidad de TypeScript. Se recomienda especialmente un tray.svg dedicado solo a la marca.

--targets tray

Compilación de ejemplo

Una sola fuente. Ramas explícitas.

El master.svg (archivo maestro) editable sigue siendo la fuente de verdad junto al proyecto. Los archivos generados siempre se pueden reconstruir.

icon-out/
├── favicon.svg
├── favicon.ico
├── icon-192.png
├── icon-512.png
├── icon-512-maskable.png
├── icons/
│   ├── icon.ico
│   └── icon.icns
├── build/
│   ├── icon.png
│   ├── icon.ico
│   └── icon.icns
└── tray/
    ├── tray.png
    ├── trayTemplate.png
    └── trayIcon.ts

Límites conocidos

Trabajar en local no significa
que sea mágico.

  • Hoy, instalación desde el código fuente.IconFlow aún no está publicado en PyPI. No uses pip install ai-iconflow hasta que exista una versión oficial.
  • Descarga única.La configuración necesita acceso a la red para las dependencias y Playwright Chromium; después, el renderizado y las compilaciones son locales.
  • Alcance de escritorio.La salida de Tauri cubre actualmente los activos de escritorio, no los conjuntos de inicio e iconos de Android o iOS.
  • Prueba ligada a la cadena de herramientas.La repetibilidad presupone el mismo SVG normalizado, la misma configuración y las mismas versiones de IconFlow, Chromium y Pillow.

Listo para tu proyecto

Empieza por la tarea.
Termina con pruebas.

Ejecuta una vez la prueba del motor. Después abre el repositorio de tu producto, da al agente un brief concreto y conserva cada decisión de diseño donde los futuros mantenedores puedan inspeccionarla.

Instala IconFlow Lee el manual de diseño