Acerca de AgentGIF
Alojamiento de GIFs para desarrolladores con arquitectura de doble capa: GIF para humanos, Cast para agentes.
¿Qué es AgentGIF?
AgentGIF es una plataforma de alojamiento diseñada específicamente para GIFs de demostración de terminal. Cada GIF subido a AgentGIF tiene dos capas:
- Capa visual — una imagen GIF animada que se reproduce directamente en los README de GitHub, sitios de documentación y publicaciones de blog. No se requiere reproductor JavaScript.
- Capa máquina — un archivo cast de asciinema v2 acompañado de una transcripción en texto plano, para que los agentes de IA puedan leer los comandos, entender la salida y referenciar pasos específicos.
Este enfoque de doble capa significa que una sola URL sirve a ambas audiencias: un humano ve una demostración animada de terminal, mientras que un agente de IA obtiene datos estructurados que puede analizar y procesar.
¿Por qué AgentGIF?
Los GIFs de demostración de terminal están en todas partes en la documentación de código abierto. Pero tienen dos problemas fundamentales:
- Las imágenes GIF son opacas para la IA — cuando un agente de IA encuentra un GIF en un README, ve datos de píxeles binarios. No puede extraer los comandos, leer la salida ni explicar los pasos. AgentGIF resuelve esto adjuntando archivos cast y transcripciones legibles por máquina a cada GIF.
- Sin alojamiento dedicado — los desarrolladores suben GIFs de terminal a hosts de imágenes genéricos (Imgur, activos de GitHub) que eliminan metadatos, comprimen agresivamente y no ofrecen búsqueda ni organización. AgentGIF proporciona alojamiento especializado con etiquetas, colecciones, temas de terminal, búsqueda de texto completo y una API REST.
Características de la plataforma
| Característica | Detalles |
|---|---|
| Biblioteca de GIFs | 768+ GIFs de terminal públicos en 911+ etiquetas |
| Temas de terminal | 44 temas de VHS (Catppuccin, Dracula, Tokyo Night, Nord, Solarized, y más) |
| Formatos de incrustación | Markdown, HTML, iframe, widget Script, oEmbed, badge SVG |
| Herramientas CLI | Python, Node.js, Go, Rust, Ruby — sube, graba y busca desde el terminal |
| API REST | 30+ endpoints, lecturas gratuitas sin autenticación, especificación OpenAPI 3.1 |
| Búsqueda de texto completo | Busca por título, comando, etiquetas y contenido de transcripción |
| Colecciones | Curated groups of related GIFs (e.g., "Unix Essentials", "Git Workflows") |
| Servicio de badges | Badges de paquetes con tema de terminal para PyPI, npm, crates.io y GitHub |
| Generador de cintas de IA | Genera archivos de cinta VHS a partir de descripciones en lenguaje natural |
| Endpoints .md | Añade .md a cualquier URL para obtener salida Markdown optimizada para LLM |
| i18n | 15 idiomas con metadatos traducidos automáticamente |
Diseñado para agentes de IA
AgentGIF está diseñado desde cero para el consumo por agentes de IA. Cada página del sitio tiene un endpoint .md que devuelve Markdown limpio. La plataforma ofrece múltiples canales de descubrimiento:
| Canal | URL | Propósito |
|---|---|---|
| llms.txt | /llms.txt | Resumen de la estructura del sitio para rastreadores de IA |
| OpenAPI | /api/openapi.json | Esquema completo de la API (OpenAPI 3.1) |
| RSS/Atom | /feed/ | GIFs más recientes para lectores de feeds |
| Mapa del sitio | /sitemap.xml | Todas las URLs indexadas |
| API de búsqueda | /api/v1/search/?q=... | Búsqueda de texto completo programática |
Ecosistema de código abierto
AgentGIF ofrece herramientas CLI e integraciones en 5 registros de paquetes:
| Plataforma | Paquete | Instalar |
|---|---|---|
| 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 |
Tecnología
| Capa | Stack |
|---|---|
| Backend | Django 6.0, Python 3.14, PostgreSQL |
| Frontend | Tailwind CSS, Alpine.js, xterm.js (reproducción de terminal) |
| CDN | Cloudflare R2 (cubo doble: estático + cargas) |
| Búsqueda | Búsqueda de texto completo de PostgreSQL con ranking ponderado |
| Grabación | VHS de Charm (44 temas de terminal) |
| Formato cast | asciinema v2 (cabecera JSON + eventos con marca de tiempo) |
Contacto
Para problemas de seguridad, consulta security.txt. Para preguntas sobre la API, consulta la referencia de la API. Para todo lo demás, escríbenos a [email protected].