background-removal

Descripción general

Qué hace la skill background-removal

La background-removal skill automatiza la eliminación de fondos en imágenes con alta calidad usando el modelo BiRefNet a través de la CLI de inference.sh (infsh).

Está pensada para:

• Fotos de producto limpias para e‑commerce y marketplaces
• Recortes de retratos y fotos de perfil
• Creatividades de marketing y redes sociales que necesitan PNGs transparentes
• Edición rápida de fotos cuando quieres eliminar o sustituir el fondo con el mínimo trabajo manual

La skill usa únicamente herramientas de inference.sh (comandos de Bash infsh *), por lo que se integra de forma natural en scripts de shell, pipelines de CI y otros flujos automatizados de procesamiento de imágenes.

Capacidades principales

• Eliminación precisa de fondos con BiRefNet para recortar el sujeto con claridad
• Salida con fondo transparente, ideal para exportar PNGs y hacer composiciones
• Cambios de fondo basados en prompt usando la app falai/reve (por ejemplo, sustituir por una nueva escena)
• Flujo de trabajo de generar y luego editar, donde primero creas una imagen con un modelo de IA y después la perfeccionas eliminando o cambiando el fondo

Para quién es esta skill

Usa la skill background-removal si:

• Gestionas catálogos de e‑commerce y necesitas imágenes de producto limpias y consistentes
• Trabajas en marketing o diseño y quieres automatizar tareas repetitivas de recorte
• Ejecutas pipelines de imágenes por lotes (scripts o jobs de CI) y quieres eliminar fondos desde la CLI
• Ya usas o estás dispuesto a usar la inference.sh CLI para ejecutar modelos de imagen con IA

Es menos adecuada si necesitas:

• Solo un editor gráfico de escritorio (sin usar terminal)
• Procesamiento totalmente offline, sin inferencia de IA remota
• Máscaras extremadamente precisas, a nivel de píxel, definidas a mano en lugar de usar la salida del modelo

Cómo usarla

Requisitos previos

Antes de usar la skill background-removal, asegúrate de tener:

• Un entorno de terminal operativo (macOS, Linux o WSL/PowerShell en Windows)
• La inference.sh CLI (infsh) instalada
• Una cuenta de inference.sh para ejecutar apps como infsh/birefnet y falai/reve

Las instrucciones de instalación de la CLI se mantienen en el repositorio:

• https://raw.githubusercontent.com/inference-sh/skills/refs/heads/main/cli-install.md

Instalar la skill background-removal

Instala la skill en tu agente o entorno local de skills con:

npx skills add https://github.com/inferen-sh/skills --skill background-removal

Este comando descarga la configuración de background-removal desde el repositorio inferen-sh/skills para que tu agente pueda invocar las apps y workflows de infsh correspondientes.

Paso 1 – Inicia sesión con la CLI de inference.sh

Tras instalar infsh, autentícate para poder ejecutar modelos:

infsh login

Sigue las instrucciones que aparecerán en pantalla para completar el inicio de sesión.

Paso 2 – Ejecuta BiRefNet para eliminar el fondo

Para una eliminación de fondo directa (por ejemplo, transformar una foto de producto en un PNG transparente), llama a la app BiRefNet directamente desde la CLI:

infsh app run infsh/birefnet --input '{
  "image_url": "https://your-photo.jpg"
}'

Sustituye https://your-photo.jpg por una URL de imagen accesible públicamente. La app devuelve una salida en JSON con enlaces a la imagen procesada con el fondo eliminado.

Paso 3 – Editar fondos con Reve (opcional)

Si quieres ir más allá de simplemente eliminar el fondo —por ejemplo, cambiarlo por una escena concreta—, la skill muestra cómo usar Reve para edición de imagen.

Eliminar el fondo y dejarlo transparente

infsh app run falai/reve --input '{
  "prompt": "remove the background, make it transparent",
  "image_url": "https://portrait.jpg"
}'

Cambiar el fondo por una nueva escena

infsh app run falai/reve --input '{
  "prompt": "change the background to a beach",
  "image_url": "https://product-photo.jpg"
}'

Ajusta el texto del prompt para describir el fondo que quieres (blanco de estudio, degradado, oficina, naturaleza, etc.).

Paso 4 – Generar y luego editar (workflow de imagen con IA)

La skill background-removal también ilustra un patrón de generar y editar:

1. Genera una imagen con un modelo de IA
2. Edítala para eliminar o ajustar el fondo

Ejemplo (estructura basada en el fragmento del repositorio):

# 1. Generate an image
infsh app run falai/flux-dev-lora --input '{
  "prompt": "a cute robot mascot"
}' > robot.json

# 2. Extract the image_url from robot.json (using jq or similar), then edit with Reve
# (Pseudo-example; adapt to your own tooling)
IMAGE_URL=$(jq -r '.image_url' robot.json)

infsh app run falai/reve --input "{
  \"prompt\": \"remove background, make it transparent\",
  \"image_url\": \"$IMAGE_URL\"
}"

Este patrón funciona muy bien si primero generas muchas imágenes y luego las procesas por lotes para campañas de marketing o usos de producto.

Integración en scripts y automatización

Como la skill background-removal se usa desde la CLI, se integra fácilmente con scripts de Bash o flujos de CI:

• Iterar sobre un CSV o una lista de URLs de imágenes de producto
• Llamar a infsh app run infsh/birefnet para cada una
• Guardar las URLs devueltas o los archivos descargados dentro de tu pipeline de assets

Ejemplo de esquema en Bash:

while read -r URL; do
  echo "Processing $URL"
  infsh app run infsh/birefnet --input "{\"image_url\": \"$URL\"}" >> results.json
done < product-images.txt

Adáptalo a tu propio sistema de almacenamiento (S3, CDN, carpetas locales) y a tus necesidades de postprocesado.

Preguntas frecuentes

¿Cuándo debería usar la skill background-removal en lugar de un editor de escritorio?

Usa la background-removal skill cuando necesites una eliminación de fondos repetible y automatizable, especialmente para un gran volumen de imágenes. Es ideal para equipos que prefieren herramientas de CLI, automatización o integrar edición de imágenes con IA en pipelines ya existentes. Para ediciones puntuales donde prefieres control visual, puede resultarte más cómodo un editor de escritorio.

¿En qué modelos y herramientas se basa background-removal?

La skill se apoya en:

• BiRefNet (infsh/birefnet) para eliminación de fondos de alta precisión
• Reve (falai/reve) para edición de imagen basada en prompts, incluyendo cambios de fondo
• flux-dev-lora (falai/flux-dev-lora) en el flujo de ejemplo para generación de imágenes
• La inference.sh CLI (infsh) como interfaz de ejecución

¿Necesito la inference.sh CLI para que esta skill funcione?

Sí. La skill background-removal asume que tienes la inference.sh CLI instalada y configurada. Los comandos que se muestran en la skill (como infsh login y infsh app run ...) no funcionarán sin ella.

¿Puedo usar archivos de imagen locales en lugar de URLs?

Los ejemplos del repositorio usan image_url con enlaces HTTP. La compatibilidad con archivos locales depende de las capacidades actuales de la CLI infsh y de las definiciones concretas de cada app. Consulta la documentación más reciente de infsh y la referencia de apps para infsh/birefnet y falai/reve para comprobar si en tu entorno se admiten rutas de archivos locales o subidas de archivos.

¿Es adecuada la skill background-removal para uso totalmente offline?

No. La skill background-removal llama a apps de inferencia remota a través de la plataforma inference.sh, por lo que necesita acceso a la red. Si necesitas procesamiento exclusivamente offline, tendrías que usar otra solución ejecutada en local.

¿Cuáles son los casos de uso típicos para marketing y e‑commerce?

Algunos usos habituales son:

• Convertir fotos de producto en bruto en PNGs transparentes y limpios para tiendas online y marketplaces
• Estandarizar los fondos de un catálogo (por ejemplo, todos en blanco o gris claro)
• Preparar creativos de campaña eliminando o cambiando fondos en imágenes principales
• Limpiar rápidamente fotos de influencers o retratos para landing pages y redes sociales

¿Cómo puedo empezar rápido con la mínima configuración?

1. Instala la inference.sh CLI siguiendo las instrucciones de cli-install.md.
2. Ejecuta infsh login.
3. Prueba con una sola imagen:

   infsh app run infsh/birefnet --input '{
     "image_url": "https://your-photo.jpg"
   }'
   

4. Cuando te convenza el resultado, integra el comando en tus scripts o configuración de agente a través de la skill background-removal.

¿Dónde puedo ver la configuración de la skill?

En el repositorio inferen-sh/skills, abre el archivo tools/image/background-removal/SKILL.md. Ahí se documentan el nombre de la skill, su descripción, las herramientas permitidas y los comandos de ejemplo que se resumen en esta guía.