Preguntas frecuentes
Preguntas comunes sobre AgentGIF, la plataforma de alojamiento de GIFs para desarrolladores.
¿Qué es AgentGIF?
AgentGIF es una plataforma de alojamiento de GIFs para desarrolladores con arquitectura de doble capa. Cada GIF de demostración de terminal se empareja con un archivo cast de asciinema v2 legible por máquina, para que tanto humanos como agentes de IA puedan entender el contenido.
Un humano ve una grabación de terminal animada. Un agente de IA ve datos estructurados: comandos, salida, marcas de tiempo y metadatos.
¿Es AgentGIF gratuito?
Sí. Subir, alojar e incrustar GIFs es completamente gratuito. La API REST es gratuita para operaciones de lectura sin autenticación requerida. Las operaciones de escritura (subir, editar, eliminar) requieren una clave de API gratuita desde tu página de configuración.
¿Qué es un archivo cast?
Un archivo cast es una grabación de asciinema v2. Es un formato de texto donde la línea 1 es una cabecera JSON con metadatos del terminal, seguida de tuplas de eventos con marca de tiempo:
{"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"]Cada tupla es [timestamp_seconds, event_type, data]. Esto permite a los agentes de IA extraer comandos, salida y temporización sin OCR.
¿Cómo subo un GIF?
Dos opciones:
- Web: Arrastra y suelta en /upload/ (requiere inicio de sesión con GitHub)
- CLI:
agentgif upload demo.gif --title "My Demo" --tags cli,unix
El CLI está disponible para 5 lenguajes: Python, Node.js, Go, Rust y Ruby. Incluye el flag --cast demo.cast para adjuntar la capa legible por máquina.
¿Cómo incrustó un GIF en mi README?
El patrón recomendado para los README de GitHub:
<p align="center">
<a href="https://agentgif.com/ID">
<img src="https://media.agentgif.com/ID.gif" alt="demo" width="800">
</a>
</p>Reemplaza ID con el ID de 8 caracteres de tu GIF. Consulta la guía de incrustación completa para los 6 métodos.
¿Qué es el endpoint .md?
Añade .md a cualquier URL de AgentGIF para obtener una respuesta text/markdown optimizada para LLMs. Cada página lo admite — detalles de GIFs, listados de etiquetas, páginas de herramientas, colecciones, guías y resultados de búsqueda.
curl https://agentgif.com/tools/git/.md
curl https://agentgif.com/explore/tags/docker/.md¿Necesito una clave de API?
| Operación | Autenticación requerida |
|---|---|
| Búsqueda, listado, detalle, cast, transcripción | No — completamente abierto |
| Subir, editar, eliminar GIFs | Sí — cabecera X-API-Key |
| Crear/gestionar colecciones | Sí — cabecera X-API-Key |
Obtén una clave de API gratuita en /settings/ después de iniciar sesión con GitHub.
¿Qué temas de terminal están disponibles?
AgentGIF admite los 44 temas de terminal de VHS. Opciones populares:
| Tema | Estilo |
|---|---|
| Catppuccin Mocha | Oscuro cálido con acentos pastel (predeterminado) |
| Dracula | Clásico morado oscuro |
| Tokyo Night | Oscuro moderno centrado en azul |
| Nord | Paleta azul ártica |
| Solarized Dark/Light | Colores de precisión |
| GitHub Dark/Light | Temas nativos de GitHub |
Explora todos los temas con vistas previas en vivo: Galería de temas.
¿Qué es el servicio de badges?
AgentGIF proporciona badges de paquetes con tema de terminal como alternativa a shields.io. Se renderizan con los colores del tema de terminal que elijas.
Proveedores compatibles: PyPI, npm, crates.io, GitHub. Personaliza con los parámetros ?theme= y ?style=. Consulta el área de pruebas de badges.
¿Cómo leen los GIFs los agentes de IA?
Los agentes de IA pueden acceder al contenido de GIFs a través de múltiples canales:
- Archivos cast:
GET /api/v1/gifs/{id}/cast/— grabación completa de asciinema v2 con marcas de tiempo - Transcripciones:
GET /api/v1/gifs/{id}/transcript/— texto plano limpio, códigos ANSI eliminados - Endpoints .md: Añade
.mda cualquier URL de página para salida Markdown - API JSON:
/api/v1/search/?q=docker— búsqueda de texto completo con resultados estructurados - llms.txt:
/llms.txt— resumen a nivel de sitio para rastreadores de IA
Consulta la documentación completa de integración con agentes de IA.
¿Qué formatos de archivo son compatibles?
| Formato | Tamaño máximo | Propósito |
|---|---|---|
| GIF | 10 MB | Formato visual principal — se reproduce en cualquier parte |
| Cast (.cast) | 5 MB | Capa legible por máquina (opcional al subir) |
| MP4 | Generado automáticamente | Alternativa de reproducción eficiente |
Para mejores resultados, mantén los GIFs por debajo de 5 MB. Consulta la guía de grabación para consejos de optimización.
¿Cómo grabo un GIF de terminal?
Recomendamos VHS de Charm para grabaciones con script y reproducibles:
# 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.tapeInstrucciones completas paso a paso: Cómo grabar un GIF de terminal.