Communitygithub.com

FilippTrigub/abra

Supprime l'arrière-plan de chaque image d'une vidéo grâce à l'IA (BiRefNet-general via rembg). Produit une vidéo avec arrière-plan transparent ou compositée sur une couleur unie ou une image. Nécessite un GPU CUDA avec au moins 3 Go de VRAM libre.

Qu'est-ce que abra ?

Cette compétence permet de supprimer automatiquement l'arrière-plan de toutes les images d'une vidéo en utilisant le modèle de matting haute qualité BiRefNet-general (via la bibliothèque rembg). Elle offre également la possibilité de composer la vidéo résultante sur une couleur unie ou une image de fond, tout en préservant l'audio original. Idéale pour les vidéos de type talking head, démos produits ou contenus nécessitant un fond transparent (export en séquence PNG avec canal alpha). L'outil nécessite un GPU CUDA avec au moins 3 Go de VRAM libre et est conçu pour être exécuté depuis une interface agent (comme Claude Code). L'utilisateur configure via un fichier JSON la couleur/image de fond, le modèle de matting (plusieurs options disponibles : birefnet-general, birefnet-portrait, isnet-general-use, u2net_human_seg) et les dossiers d'entrée/sortie. Une fois lancé, le traitement est parallélisé et les erreurs (VRAM insuffisante, absence de GPU) sont clairement signalées.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FilippTrigub/abra/tree/HEAD/skills/video-matte

Demander à votre IA préférée

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

Documentation

keyer — Suppression d'arrière-plan vidéo par IA

Supprime l'arrière-plan de chaque image d'une vidéo en utilisant BiRefNet-general (un modèle de matting haute qualité via rembg). Propose optionnellement la composition sur une couleur unie ou une image de fond. L'audio est conservé.

Le répertoire de la compétence (où se trouve ce SKILL.md) est désigné ci-dessous par $SKILL_DIR.

GPU requis. Nécessite un GPU CUDA avec ≥ 3 Go de VRAM libre. Si le contexte LLM occupe de la VRAM, mettez-le en pause avant d'exécuter.


Quand l'utiliser

Utilisez cette compétence lorsque l'utilisateur souhaite :

  • Supprimer l'arrière-plan d'une vidéo (talking head, démo produit, etc.)
  • Placer un sujet sur une couleur unie ou un fond aux couleurs de la marque
  • Exporter une vidéo avec un arrière-plan transparent (images PNG avec canal alpha)

Configuration (première exécution uniquement)

cd "$SKILL_DIR" && uv sync

Les poids du modèle BiRefNet sont téléchargés automatiquement lors de la première exécution (~500 Mo).


Workflow de l'agent

1. Interroger l'utilisateur

Avant de supprimer l'arrière-plan, j'ai besoin de savoir :

🎭 Remplacement d'arrière-plan
  - null          — conserver le canal alpha transparent (images PNG ; pas d'alpha dans mp4)
  - #hex couleur   — par ex. "#1a1a2e" pour bleu nuit foncé
  - /chemin/vers/fond   — composer avec un fichier image

🧠 Modèle
  - birefnet-general   — meilleure qualité générale  [par défaut]
  - birefnet-portrait  — optimisé pour les personnes
  - isnet-general-use  — alternative plus rapide
  - u2net_human_seg    — rapide, réservé aux humains

📁 Répertoires d'entrée / sortie  (par défaut : ./input et ./output)

Attendez la réponse de l'utilisateur avant de continuer.

2. Modifier config.json

Écrire ou mettre à jour $SKILL_DIR/config.json en fonction des choix de l'utilisateur.

3. Exécuter

cd "$SKILL_DIR" && uv run python scripts/matte.py --config config.json

4. Rapporter les résultats

Indiquer à l'utilisateur les chemins des fichiers de sortie et le mode d'arrière-plan utilisé.


Référence de configuration

CléValeursDéfautDescription
input_dirchemin./inputDossier contenant les vidéos d'entrée
output_dirchemin./outputDossier de destination
modelvoir ci-dessusbirefnet-generalModèle de matting
bgnull / hex / cheminnullRemplacement d'arrière-plan

Invocations courantes

# Défaut : supprimer l'arrière-plan, sortie transparente
cd "$SKILL_DIR" && uv run python scripts/matte.py

# Composition sur fond sombre
cd "$SKILL_DIR" && uv run python scripts/matte.py --bg "#0d0d0d"

# Composition sur une image
cd "$SKILL_DIR" && uv run python scripts/matte.py --bg /chemin/vers/fond_studio.jpg

# Modèle optimisé pour les portraits
cd "$SKILL_DIR" && uv run python scripts/matte.py --model birefnet-portrait

# Fond nul (passer la chaîne "null" via CLI)
cd "$SKILL_DIR" && uv run python scripts/matte.py --bg null

Sortie

Chaque vidéo d'entrée produit un fichier .mp4 de sortie dans output_dir avec le même nom de fichier. Si bg=null, la sortie est encodée avec yuv420p (pas de transparence réelle dans mp4) ; pour des images vraiment transparentes, exécutez clawimig ou exportez en séquence PNG.


Gestion des erreurs

  • VRAM insuffisante → affiche la VRAM requise vs disponible, donne des astuces pour libérer de la VRAM, se termine
  • Pas de GPU CUDA / ONNX CUDAExecutionProvider manquant → message d'erreur clair, se termine
  • Aucune vidéo dans input_dir → message clair, se termine
  • Erreurs individuelles sur une vidéo → enregistrées dans les logs ; les autres vidéos continuent d'être traitées

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

FilippTrigub/abra

>- Animate a still image into a short video clip using fal.ai's LTX-2.3 Fast image-to-video model in the cloud. No GPU required - runs entirely on fal.ai serverless infrastructure.

FilippTrigub/abra

>- Auto-describe and caption images using a local vision-language model. Writes a JSON sidecar per image containing a one-sentence description, a suggested Instagram caption with hashtags, and detected content tags.

FilippTrigub/abra

>- Animated caption pipeline. Use this skill when the user wants to burn word-by-word animated captions into videos — using Whisper for transcription and pycaps for rendering. Supports default minimalist style or a futuristic CSS theme with alternating gold/magenta glowing words.

FilippTrigub/abra

>- Cut videos into segments, rearrange them, and produce an output video with a specific cuts-per-second rate. Uses MoviePy for video manipulation. Prioritizes audio transcription for timestamped cutting, falls back to adaptive scene detection.

FilippTrigub/abra

>- Edit a region of a video using a text prompt via Wan2.1-VACE inpainting. Supports two modes: background (auto-segment via rembg) or region (rectangle defined by fractions). Requires a CUDA GPU with at least 8 GB free VRAM.

FilippTrigub/abra

>- Video enhancement pipeline. Use this skill when the user wants to sharpen, colour grade, warm, or normalise the audio of videos — including presets for natural, cinematic, or vivid looks.

FilippTrigub/abra

Generate videos from text or images using Higgsfield's multi-model cloud platform. Supports kling, seedance, dop, and dop-preview models. Uses a small preset layer for common creative styles. Auto-detects text-to-video or image-to-video based on input. No GPU required.

Skills associés