À propos d'AgentGIF
Hébergement de GIF pour développeurs avec architecture double couche : GIF pour les humains, Cast pour les agents.
Qu'est-ce qu'AgentGIF ?
AgentGIF est une plateforme d'hébergement conçue spécifiquement pour les GIF de démonstration terminal. Chaque GIF téléversé sur AgentGIF possède deux couches :
- Couche visuelle — une image GIF animée qui se lit directement dans les README GitHub, les sites de documentation et les billets de blog. Aucun lecteur JavaScript requis.
- Couche machine — un fichier cast asciinema v2 associé à une transcription en texte brut, permettant aux agents IA de lire les commandes, comprendre la sortie et référencer des étapes précises.
Cette approche double couche signifie qu'une seule URL sert les deux audiences : un humain voit une démo terminal animée, tandis qu'un agent IA reçoit des données structurées qu'il peut analyser et exploiter.
Pourquoi AgentGIF ?
Les GIF de démonstration terminal sont omniprésents dans la documentation open source. Mais ils présentent deux problèmes fondamentaux :
- Les images GIF sont opaques pour l'IA — lorsqu'un agent IA rencontre un GIF dans un README, il ne voit que des données binaires de pixels. Il ne peut pas extraire les commandes, lire la sortie ni expliquer les étapes. AgentGIF résout ce problème en associant des fichiers cast et des transcriptions lisibles par machine à chaque GIF.
- Pas d'hébergement dédié — les développeurs téléversent des GIF terminaux sur des hébergeurs d'images génériques (Imgur, GitHub assets) qui suppriment les métadonnées, compriment agressivement et n'offrent ni recherche ni organisation. AgentGIF fournit un hébergement dédié avec étiquetage, collections, thèmes terminal, recherche plein texte et une API REST.
Fonctionnalités de la plateforme
| Fonctionnalité | Détails |
|---|---|
| Bibliothèque de GIF | 768+ GIF terminaux publics répartis sur 911+ étiquettes |
| Thèmes terminal | 44 thèmes VHS (Catppuccin, Dracula, Tokyo Night, Nord, Solarized, et plus) |
| Formats d'intégration | Markdown, HTML, iframe, widget Script, oEmbed, badge SVG |
| Outils CLI | Python, Node.js, Go, Rust, Ruby — téléverser, enregistrer, rechercher depuis le terminal |
| API REST | 30+ points d'accès, lectures gratuites sans authentification, spec OpenAPI 3.1 |
| Recherche plein texte | Recherche par titre, commande, étiquettes et contenu de transcription |
| Collections | Curated groups of related GIFs (e.g., "Unix Essentials", "Git Workflows") |
| Service de badges | Badges de paquets sur le thème terminal pour PyPI, npm, crates.io et GitHub |
| Générateur de tape IA | Génération de fichiers tape VHS à partir de descriptions en langage naturel |
| Points d'accès .md | Ajoutez .md à n'importe quelle URL pour une sortie Markdown optimisée pour les LLM |
| i18n | 15 langues avec métadonnées traduites automatiquement |
Conçu pour les agents IA
AgentGIF est conçu de fond en comble pour la consommation par les agents IA. Chaque page du site possède un point d'accès .md qui renvoie du Markdown propre. La plateforme propose plusieurs canaux de découverte :
| Canal | URL | Rôle |
|---|---|---|
| llms.txt | /llms.txt | Résumé de la structure du site pour les robots IA |
| OpenAPI | /api/openapi.json | Schéma API complet (OpenAPI 3.1) |
| RSS/Atom | /feed/ | Derniers GIF pour les lecteurs de flux |
| Plan du site | /sitemap.xml | Toutes les URLs indexées |
| API de recherche | /api/v1/search/?q=... | Recherche plein texte par programme |
Écosystème open source
AgentGIF fournit des outils CLI et des intégrations sur 5 registres de paquets :
| Plateforme | Paquet | Installation |
|---|---|---|
| PyPI | agentgif | pip install agentgif |
| npm | @agentgif/cli | npm install -g @agentgif/cli |
| Go | github.com/agentgif/cli | go install github.com/agentgif/cli@latest |
| Crates.io | agentgif | cargo install agentgif |
| RubyGems | agentgif | gem install agentgif |
Technologie
| Couche | Stack |
|---|---|
| Backend | Django 6.0, Python 3.14, PostgreSQL |
| Frontend | Tailwind CSS, Alpine.js, xterm.js (relecture terminal) |
| CDN | Cloudflare R2 (double bucket : statique + téléversements) |
| Recherche | Recherche plein texte PostgreSQL avec classement pondéré |
| Enregistrement | VHS by Charm (44 thèmes terminal) |
| Format Cast | asciinema v2 (en-tête JSON + événements horodatés) |
Contact
Pour les problèmes de sécurité, consultez security.txt. Pour les questions API, consultez la référence API. Pour tout le reste, contactez-nous à [email protected].