CommunityImagegithub.com

fond-transparent

Transforme une image sur fond uni ou quasi-uni (illustration, sticker, logo, scan, photo de produit sur fond blanc) en un PNG transparent propre, puis corrige les artefacts résiduels (halo blanc, bords crénelés, pixels de fond entre les mèches de cheveux ou dans les contours) et permet éventuellement de recolorer des formes séparées (marques, texte, icônes) avec une couleur donnée ou échantillonnée.

Qu'est-ce que fond-transparent ?

Ce skill est conçu pour nettoyer et traiter des images à fond uni ou quasi-uni, idéal pour les logos, illustrations, stickers, scans ou photos de produits sur fond blanc. Il repose sur un script Python unique, `scripts/imgalpha.py`, exécuté via `uv` sans installation globale, compatible macOS, Linux et Windows. Le flux de travail guide l'utilisateur en sept étapes : inspecter l'image, ne jamais modifier l'original (sauvegarde automatique dans un dossier `backup/`), supprimer le fond, inspecter le résultat sur un fond contrasté, corriger les problèmes un par un (halos, pixels résiduels, etc.), éliminer les pixels résiduels entre les mèches ou dans les contours avec l'option `specks`, et éventuellement recolorer des formes séparées à l'aide des sous-commandes `components` et `recolor`. Les couleurs peuvent être spécifiées en `r,g,b` ou `#rrggbb`. Le skill insiste sur l'inspection visuelle systématique du résultat après chaque étape et fournit des références détaillées dans `references/troubleshooting.md` pour chaque symptôme. Il est particulièrement utile pour les développeurs et designers qui ont besoin d'un contrôle précis sur le détourage et la recoloration d'images vectorielles ou à fond simple, sans recourir à des modèles d'IA de matting.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shino369/kyoten-skills/tree/HEAD/skills/transparent-background

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Fond Transparent

Un seul script, scripts/imgalpha.py, fait le travail. Exécutez-le via uv (sans installation globale) sur macOS, Linux ou Windows. Définissez l'assistant ia une fois par session shell, depuis le dépôt. Il résout un chemin absolu, donc un cd ultérieur ne pose pas de problème. Les exemples ci-dessous l'utilisent.

bash / zsh / Git Bash :

IA_PY="$(git rev-parse --show-toplevel)/.agents/skills/transparent-background/scripts/imgalpha.py"
ia() { uv run --quiet --python 3.12 --with pillow --with numpy --with scipy python -I "$IA_PY" "$@"; }
ia remove in.jpg -o out.png

PowerShell (cmd.exe n'a pas de fonctions, utilisez donc PowerShell ou Git Bash) :

$IA_PY = Join-Path (git rev-parse --show-toplevel) '.agents/skills/transparent-background/scripts/imgalpha.py'
function ia { uv run --quiet --python 3.12 --with pillow --with numpy --with scipy python -I $IA_PY @args }
ia remove in.jpg -o out.png

Écrivez les couleurs au format r,g,b (ex. --bg 40,96,200). Cela ne nécessite aucun guillemet dans tous les shells. Le format #rrggbb fonctionne aussi, mais mettez-le entre guillemets : PowerShell traite un # nu comme un commentaire, et cmd conserve les guillemets simples.

Flux de travail

  1. D'abord, inspectez. Lisez l'image. Ce script convient aux fonds unis ou quasi-unis. Pour les photos ou les fonds chargés, utilisez plutôt un modèle de matting IA (rembg, voir references/troubleshooting.md).

  2. Ne touchez jamais à l'original. Écrivez dans un nouveau fichier. Avant de modifier un résultat sur place, copiez-le dans un dossier backup/<aammjj-hhmm>/ à côté. Le script refuse -o = fichier d'entrée sauf si --in-place.

  3. Supprimez le fond : ia remove in.jpg -o out.png. La couleur du fond est la médiane de la bordure (--bg 255,255,255 pour forcer). Il supprime le fond connecté aux bords ainsi que les poches fermées de la teinte du fond qui n'ont pas de trou, donc la peau, les rayures blanches et les détails en forme d'anneau sont préservés.

  4. Inspectez sur une couleur contrastée, en zoomant. La transparence cache les problèmes sur fond blanc :

    ia preview out.png -o check.jpg --bg 40,96,200 --crop 600,140 --crop 260,1140,60
    

    Lisez check.jpg. Vérifiez aussi sur un fond sombre. Recherchez les halos, les crénelures, les trous dans les détails clairs, le blanc résiduel.

  5. Corrigez ce que vous voyez, un problème à la fois, en ré-inspectant après chaque correction. Symptôme → table de correction : references/troubleshooting.md.

  6. Extras optionnels : pixels résiduels (ci-dessous), recoloration (ci-dessous).

  7. Rapportez le chemin de sortie, ce qui a changé, ce qui a été délibérément conservé, et l'emplacement de la sauvegarde.

Pixels résiduels (specks)

Fins filaments blancs entre les mèches de cheveux ou dans les contours sombres. Marquez toujours avant de remplir :

ia specks out.png --mark marked.jpg          # entoure chaque candidat ; affiche le nombre
ia specks out.png -o fixed.png --keep 1237,1467   # remplit ; protège une étincelle intentionnelle

Lisez marked.jpg et vérifiez chaque cercle. Si l'un d'eux se trouve sur une partie artistique réelle (dentelle, reflet d'œil, étincelle), utilisez --keep x,y ou une --region x0,y0,x1,y1. Comparez ensuite avant/après avec preview --crop. Les paramètres par défaut sont adaptés aux zones sombres et neutres (cheveux noirs, contours). Pour les zones colorées, augmentez --surround-max-sat.

Recoloration des formes (components, recolor)

ia components out.png                    # id, bbox, taille, couleur moyenne de chaque forme
ia recolor out.png -o red.png --at 200,640 --at 1400,500 --like other.png --like-at 1350,880
ia recolor out.png -o red.png --ids 2,3 --color 228,100,91

--like échantillonne la couleur et la texture de la forme à --like-at dans une image de référence. Chaque pixel conserve son écart de luminosité/obscurité, donc la texture du pinceau ou du crayon est préservée. Choisissez les formes avec --at (un point à l'intérieur). C'est plus sûr que les ids, qui changent lorsque l'image change.

Règles

  • Inspectez le résultat vous-même (lisez l'image d'aperçu) après chaque étape. Ne supposez pas que les valeurs par défaut ont fonctionné.
  • Passez les chemins en arguments et exécutez Python avec -I. Ne nommez jamais un fichier temporaire d'après un module stdlib (inspect.py a déjà masqué l'import de numpy).
  • Gardez les fichiers temporaires dans le dossier tmp/ de la tâche ou dans le dossier temporaire système, pas à côté des images de l'utilisateur.

Tests

Lorsque vous développez dans le dépôt du skill, exécutez la suite de tests Python avec 100 % de couverture de branches :

uv run --quiet --python 3.12 --with pytest --with pytest-cov --with pillow --with numpy --with scipy python -I -B -m pytest -q -p no:cacheprovider skills/transparent-background/scripts --cov=imgalpha --cov-branch --cov-fail-under=100

Skills associés