Questions fréquemment posées

Questions courantes sur AgentGIF, la plateforme d'hébergement de GIF pour développeurs.

Qu'est-ce qu'AgentGIF ?

AgentGIF est une plateforme d'hébergement de GIF pour développeurs avec une architecture double couche. Chaque GIF de démo terminal est associé à un fichier cast asciinema v2 lisible par machine, pour que les humains comme les agents IA puissent comprendre le contenu.

Un humain voit un enregistrement terminal animé. Un agent IA voit des données structurées : commandes, sortie, horodatages et métadonnées.

AgentGIF est-il gratuit ?

Oui. Le téléversement, l'hébergement et l'intégration de GIF sont entièrement gratuits. L'API REST est gratuite pour les opérations de lecture sans authentification requise. Les opérations d'écriture (téléversement, modification, suppression) nécessitent une clé API gratuite depuis votre page de paramètres.

Qu'est-ce qu'un fichier cast ?

Un fichier cast est un enregistrement asciinema v2. C'est un format texte où la ligne 1 est un en-tête JSON avec les métadonnées terminal, suivi de tuples d'événements horodatés :

{"version": 2, "width": 120, "height": 40}
[0.5, "o", "$ docker compose up -d\r\n"]
[1.2, "o", "Creating network...\r\n"]
[2.8, "o", "Container app-1  Started\r\n"]

Chaque tuple est [timestamp_seconds, event_type, data]. Cela permet aux agents IA d'extraire les commandes, la sortie et le timing sans OCR.

Comment téléverser un GIF ?

Deux options :

  • Web: Glisser-déposer sur /upload/ (nécessite une connexion GitHub)
  • CLI: agentgif upload demo.gif --title "My Demo" --tags cli,unix

Le CLI est disponible pour 5 langages : Python, Node.js, Go, Rust et Ruby. Incluez l'option --cast demo.cast pour attacher la couche lisible par machine.

Comment intégrer un GIF dans mon README ?

Le modèle recommandé pour les README GitHub :

<p align="center">
  <a href="https://agentgif.com/ID">
    <img src="https://media.agentgif.com/ID.gif" alt="demo" width="800">
  </a>
</p>

Remplacez ID par l'identifiant GIF de 8 caractères. Voir le guide d'intégration complet pour les 6 méthodes.

Qu'est-ce que le point d'accès .md ?

Ajoutez .md à n'importe quelle URL AgentGIF pour obtenir une réponse text/markdown optimisée pour les LLM. Chaque page le prend en charge — détails de GIF, listes d'étiquettes, pages d'outils, collections, guides et résultats de recherche.

curl https://agentgif.com/tools/git/.md
curl https://agentgif.com/explore/tags/docker/.md

Ai-je besoin d'une clé API ?

OpérationAuth requise
Recherche, liste, détail, cast, transcriptionNon — complètement ouvert
Téléverser, modifier, supprimer des GIFOui — en-tête X-API-Key
Créer/gérer des collectionsOui — en-tête X-API-Key

Obtenez une clé API gratuite sur /settings/ après vous être connecté avec GitHub.

Quels thèmes terminal sont disponibles ?

AgentGIF prend en charge les 44 thèmes terminal VHS. Choix populaires :

ThèmeStyle
Catppuccin MochaSombre chaud avec accents pastel (par défaut)
DraculaSombre violet classique
Tokyo NightSombre moderne centré sur le bleu
NordPalette bleu arctique
Solarized Dark/LightCouleurs de précision
GitHub Dark/LightThèmes natifs de GitHub

Parcourez tous les thèmes avec aperçus en direct : Galerie de thèmes.

Qu'est-ce que le service de badges ?

AgentGIF fournit des badges de paquets sur le thème terminal comme alternative à shields.io. Ils s'affichent avec les couleurs du thème terminal choisi.

![PyPI](https://agentgif.com/badge/pypi/requests/version.svg?theme=dracula)
![npm](https://agentgif.com/badge/npm/express/version.svg?theme=nord)
![Stars](https://agentgif.com/badge/github/torvalds/linux/stars.svg)

Fournisseurs pris en charge : PyPI, npm, crates.io, GitHub. Personnalisez avec les paramètres ?theme= et ?style=. Voir le terrain de jeu des badges.

Comment les agents IA lisent-ils les GIF ?

Les agents IA peuvent accéder au contenu GIF via plusieurs canaux :

  • Fichiers cast: GET /api/v1/gifs/{id}/cast/ — enregistrement asciinema v2 complet avec horodatages
  • Transcriptions: GET /api/v1/gifs/{id}/transcript/ — texte brut propre, codes ANSI supprimés
  • points d'accès .md: Ajoutez .md à n'importe quelle URL de page pour une sortie Markdown
  • API JSON: /api/v1/search/?q=docker — recherche plein texte avec résultats structurés
  • llms.txt: /llms.txt — résumé au niveau du site pour les robots IA

Voir la documentation complète d'intégration des agents IA.

Quels formats de fichiers sont pris en charge ?

FormatTaille maxRôle
GIF10 MBFormat visuel principal — lu partout
Cast (.cast)5 MBCouche lisible par machine (optionnelle au téléversement)
MP4Généré automatiquementAlternative de lecture efficace

Pour de meilleurs résultats, gardez les GIF sous 5 Mo. Voir le guide d'enregistrement pour des conseils d'optimisation.

Comment enregistrer un GIF terminal ?

Nous recommandons VHS by Charm pour des enregistrements scriptés et reproductibles :

# Install VHS
brew install vhs

# Create a tape file (demo.tape)
Output demo.gif
Set Theme "Catppuccin Mocha"
Type "echo 'Hello, world!'"
Enter
Sleep 2s

# Record
vhs demo.tape

Instructions complètes étape par étape : Comment enregistrer un GIF terminal.

← À propos · Documentation · Guides →