Getting Started · instalación desde PyPI

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.

  • Python 3.10+
  • pip / uv / pipx
  • 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 incluida en el paquete 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.

01InstalaObtén la versión actual de PyPI.
02ConfiguraInstala Chromium una sola vez.
03Ejecuta la pruebaVuelve a validar el receipt y genera 23 activos.

Windows · PowerShell


python -m venv .venv
.\.venv\Scripts\python.exe -m pip install iconflow
.\.venv\Scripts\python.exe -m iconflow demo --setup `
  --out iconflow-demo

macOS / Linux · shell


python3 -m venv .venv
./.venv/bin/python -m pip install iconflow
./.venv/bin/python -m iconflow demo --setup \
  --out iconflow-demo
Marca de IconFlow
Resultado esperado

Un control, no solo una carpeta.

demoverifica la fuente empaquetada 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 iconflow-demo/build/.

  • 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. init detecta los destinos a partir de tu proyecto y explica por qué; la configuración también fija colores, rutas y el comportamiento de la bandeja del sistema.

    python -m iconflow init --out iconflow.toml \
      --name "My App" --essence proof
  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. El presupuesto de 16px nombra cada corte, separación y acento demasiado estrecho para sobrevivir, antes de que lo haga la revisión.

    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
    python -m iconflow budget work/my-app/a.svg \
      work/my-app/b.svg --sheet work/my-app/budget.png
  4. 04
    Inspecciona

    Revisa transformaciones reales de cada destino.

    Corrige todas las advertencias; con --config, check ejecuta la misma auditoría que ship. Después inspecciona los píxeles nativos, el alfa, los recortes adaptativos, las esquinas de escritorio y los contextos de bandeja del sistema. ¿Sin navegador? --evidence escribe la misma prueba como láminas y score recorre los seis ejes de la rúbrica hasta el receipt.

    python -m iconflow check --config iconflow.toml
    python -m iconflow review --config iconflow.toml \
      --out work/my-app/review.png \
      --html work/my-app/review.html
    python -m iconflow score --config iconflow.toml \
      --evidence work/my-app/evidence ...
  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
    Propaga

    Mueve toda la identidad a la vez.

    Para una marca de producto, el kit de marca escribe composiciones con el logotipo, mosaicos de app y tarjetas para redes sociales a partir de la marca aprobada, registra cada archivo en un único manifiesto y encuentra lo que un sitio aún conserva de la marca anterior.

    python -m iconflow brand build \
      --config iconflow.toml \
      --review master-review.json --ship
    python -m iconflow brand sync \
      --manifest brand-kit --project ../my-site
  7. 07
    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
ANDROID

Iconos del lanzador

Primer plano y fondo adaptativos, la capa temática de Android 13, iconos heredados cuadrados y redondos en cinco densidades y el XML adaptativo.

--targets android
IOS

Conjunto de iconos de app

Iconos claro, oscuro y tintado de 1024 px para Xcode, más una capa para Icon Composer.

--targets ios

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.

  • Instala desde PyPI.Ejecuta pip install iconflow o uv tool install iconflow. La instalación desde el código fuente sigue disponible para quienes contribuyen.
  • 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 móvil.Los iconos de app de Android e iOS son objetivos.
  • 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.